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1 Objective 

SRDH Deployment guide provides the detail procedure for deploying the SRDH applications with 
necessary configuration changes. 

2 Environmental Pre-requisites 

The pre-requisites required for the environment are: 

• Java: JDK 1.6 , JRE 1.6 

• Server: JBoss-as-web-7.0.2 version 

• Databases: (Any one of the below databases) 

■ MySql 5.5 

■ Oracle 11 g 

■ MS SQL R2 
- DB2 

• Open LDAP 2.4 (Optional) 

• Mail Server SMTP Configuration 

• HSM Box (for Digital Signing, Encryption and Decryption) 

Note: Existing code has been tested with SafeNet 5.0.0_39 HSM box but states are free to 
choose any other HSM box and integrate with SRDH. 

• Digital signature and keys 

Please run the database scripts supplied with this deployment package before progressing 
further. 

Bouncycastle Configurations: 

Step: 1 

Locate JRE in the system. In jre\lib\security the java.security file will be there in that file need to add the 
security provider for the BouncyCastleProvider. 

JRE Location: <JRE root path>\ jre\lib\security\java.security 

security, provider. l=sun.security, provider.Sun 
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security, provider. 2=sun.security. rsa.SunRsaSign 
security. provider.3=com.sun. net.ssl. internal.ssl. Provider 
security, provider.4=com.sun.crypto, provider.SunJCE 
security. provider.5=sun.security .jgss.SunProvider 
security. provider.6=com.sun.security.sasl. Provider 
security, provider.7=org.jcp.xml.dsig. internal.dom.XMLDSigRI 
security, provider.8=sun.security.smartcardio.SunPCSC 
security.provider.9=sun.security.mscapi.SunMSCAPI 

security.provider,10=org.bouncycastle.jce.provider.BouncyCastleProvider (Need to add this line in 
java.security file) 

Step: 2 

Need to copy the bcprov-jdk16-140.jar in jre/lib/ext folder. 

Location: <JRE root path >\j re\lib\ext 


File: bcprov-jdkl6-140.jar (Need to copy this jar in to above location. This jar was provided with the SRDH 
package) 

Step: 3 

Need to copy the ' bouncycastle' folder in to jboss modules. 

Location: <jboss root path>jboss-as-web-7.0.2.Final\modules\org 


Need to copy the ' bouncycastle' folder in to above location. This bouncycastle folder was provided 
with the SRDH package. 

Step: 4 

Need to add below lines in jboss standalone.xml. 

Location: <jobss root path> jboss-as-web-7.0.2.Final\standalone\configuration\standalone.xml 
subsystem xmlns="urn:jboss:domain:ee:1.0"> 


<global-modules> 


<module name="org.bouncycastle.jce.provider" slot="main"/> 


</global-modules> 
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</subsystem> 

Add the yellow marked lines in the subsystem xmlns="urn:jboss:domain:ee:1.0"> tag. 

Generating Key and Encrypted Passwords 

Before deploying SRDH Applications it is required to generate Encryption Key and using 
this encryption key need to generate Database Encrypted Password and SRDH user encrypted 
password. 

Please follow below steps: 

Tool Pre-requisites: 

• Copy the SrdhPasswordTool.zip file from UIDAI FTP Shared folder. 

• ExtracttheSrdhPasswordTool.zip file in to your local drive. 

• Go to SrdhPasswordTool\bin folder (Example: C:\ SrdhPasswordTool\bin) 

• Follow below steps to generate key and generate passwords. 

Generating Key : 

1. Open command promt. 

2. Goto SrdhPasswordTool\bin folder. (Example: C:\ SrdhPasswordTool\bin) 

3. Type keyGen. it will generate 32 bit random Key. Copy the key and keep in secured 
location. (If you lose the key all the passwords which are generated using this key will not 
work). 

Example: 

C:\SrdhPasswordTool\bin>keyGen 

************************** Note ************************** 

Please store the below generated key in safe location. 

If you lose the key, all the passwords which are generated 
using this key will be invalid to use. 

************************** Ney *************************** 
8c8b357e248236ebc56e7ae6d43c5b3e 

It is mandatory that system administrator has to set generated key in environment 
variable; otherwise SRDH application will not work. 

SRDH_KEY=8c8b357e248236ebc56e7ae6d43c5b3e 

Setting Key as environment variable in Linux Server: 

export SRDH_KEY=8c8b357e248236ebc56e7ae6d43c5b3e 


Generating Encrypted Database Password: 
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Following are the steps to be followed for encrypting database password: 

1. Open Command prompt 

2. Goto SrdhPasswordTool\bin folder. (Example: C:\ SrdhPasswordTool\bin) 

3. Type the following command 

C:\ SrdhPasswordTool\bin>encrypt input=<Database Password>_password=<Generated 

Key> 


Example: 

C:\SrdhPasswordTool\bin>encrypt input=mydbpassword 

password=8c8b357e248236ebc56e7a 

e6d43c5b3e 

-ENVIRONMENT- 

Runtime: Sun Microsystems Inc. Java HotSpot(TM) 64-Bit Server VM 
20.9-b04 

-ARGUMENTS- 

input: mydbpassword 

password: 8c8b357e248236ebc56e7ae6d43c5b3e 
-OUTPUT- 


d5ccv4LuaBvahrQzphJig2 9dHthGM6bL 


Yellow marked is the encrypted database password for the ‘mydbpassword’. 

This encrypted database password need to copy in to the databaseproperties.properties 
file enclose with ENC(); 

Example: ENC(d5ccv4LuaBvahrQzphJig29dHthGM6bL) 


Generating Encrypted SRDH User Password: 
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For SRDH initially administrator has to generate temp encrypted password and copy in to 
database or insert script. 

Following are the steps to be followed for encrypting SFtDFI user password: 

1. Open Command prompt 

2. Go to SrdhPasswordTool\bin folder. (Example: C:\ SrdhPasswordTool\bin) 

3. Type the following command 

C:\ SrdhPasswordT ool\bin>UserPasswordEncrypt 

• It will prompt you to ‘Enter 32 bit Key’, enter the 32 bit generated key 

• It will prompt you to ‘Enter Password’, Please enter the user password. 

• It will give you output encrypted user password. 

Example: 


C:\SrdhPasswordTool\bin>UserPasswordEncrypt 
Enter 32 bit key :8c8b357e248236ebc56e7ae6d43c5b3e 


Enter password (Length::Min:6,Max:20) :admin!23$ 


Encrypted Password 


:2b33c67ec921e084 05383d7 f 9f 9babaf 


Method 1 for updating password: 

Copy the encrypted password in the SRDFI_MYSQL_DB_INSERT_SCRIPTS_V1.5.sqI file which 
provided along with the bundle. 

Step one: open the SRDH_MYSQL_DB_INSERT_SCRIPTS_V1.5.sql file. 

Step two: search for the insert script and replace the password with generated encrypted 
password. 

INSERT INTO 'srdhuser' ('userjd', 'password', 'first_name', 'last_name', 'address', 
'designation', 'phone', 'mobile', 'email', 'department', 'languagejd', 'rolejd', 'deletejlag', 
firstlogin flag', 'lastlogin_date', 'created_date', 'createdby') VALUES (’Administrator’, 
’Admin@123’, ’SRDH’, ’Administrator’, ’Address’, ’Administrator’, ’1234567890’, ’9876543210’, 
’srdhadmin@srdh.com’, ’IT’, 1,1, ’N’, ’Y’, NOWQ, NOW(), ’Administrator’); 


In the above script replace the ’Admin@123’ with the encrypted password. 

Example: 

INSERT INTO 'srdhuser' ('userjd', 'password', 'first_name', 'last_name', 'address', 
'designation', 'phone', 'mobile', 'email', 'department', 'languagejd', 'rolejd', 'deletejlag', 
firstlogin flag', 'lastlogin_date', 'created_date', 'createdby') VALUES (’Administrator’, 
’2b33c67ec921e08405383d7f9f9babaf, ’SRDFT, ’Administrator’, ’Address’, ’Administrator’, 
’1234567890’, ’987654321 O’, ’srdhadmin@srdh.com’, ’IT’, 1, 1, ’N’, ’Y’, NOW(), NOW(), 
’Administrator’); 


Method 2 for updating password: 
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After creating database and running all the provided creation and insert script run below 
command. 

Update Script for updating Encrypting Password in Database: update 
srdhcommon.srdhuser set 

password='2b33c67ec921e08405383d7f9f9babaf' where user id = 

'Administrator' ; 


Note: Do not share this tool and the generated key to any one. 
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3 SRDH Portal war deployment 

Files need to be configured: 

1. SRDHResources.properties 

2. DatabaseResources.properties 

3. authclient.properties 

4. web.xml 

5. log4j.xml 

3.1 SRDHResources.properties Property File Configurations: 

Location: srdhlportl.war web-inf/classes 

(To modify this property file, need to open the war file with 7zip/winzip and do the 
modifications and save it) 

3.1.1 LDAP Configuration (optional) 

Step 1: 

LdapAuthRequired property value can be True or False. 

True if LDAP is configured for SRDH, False if LDAP is not configured. 

Default Value : LdapAuthReqired=False 

Step 2: 

This step 2 will be applicable only if Step 1 property is set to True. 

LdapAuthType property value can be SRDHLDAP or STATELDAP. 

If SRDH users required authenticating with STATE LDAP then set the property to STATELDAP. 
If SRDH users required authenticating with SRDH LDAP then set the property to SRDHLDAP. 
Default Value: LdapAuthType=SRDHLDAP 

Step 3: 

This step 3 will be applicable only if Step 1 property is set to True. 
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url = ldap://<ip address>:<port number> (Example: ldap://l27.0.01:389) 
base= <base address> (Example: dc=uidai,dc=com) 

userDn = <user dn> (Example: cn=admin,dc=uidai,dc=com) 

password = xxxxx 

3.1.2 AUA Authentication Configurations: 

isAUAAuthenticationRequired property value can be True or False 

If AUA server is configured and the entire enrollment inserts/updates need to be authenticated 
with CIDR then set the value isAUAAuthenticationRequired=True. 

If AUA Authentication is not required set the isAUAAuthenticationRequired=False. 

3.1.3 Self Service Configurations: 

Auto generated OTP can be configured, whether OTP generation is required or not. 
sellservice.otpmandatory=True or False (Generating OTP Required or not) 
selfservice.otpvalidhours=24 (Value In Hours) OTP Valid Time 


3.1.4 Version History Table Configurations: 

VersionHistorySize property is to set the number of history records maintain for enrollment 
updates in enrollment_versions and enrollment_version_details tables. 

Default Value of VersionHistorySize = 10 

3.1.5 Search Result Configurations: 

srdh.maxSearchResults property is to set the no.of. rows retrieve from the database and display 
in the screen. 

Default Value of srdh.maxSearchResults=2000 

3.1.6 Pagination Configurations: 

srdh.displayRecordsPerPage property is to set the number of records display for the pagination. 
Default Value of srdh.displayRecordsPerPage=5 

3.1.7 Email Configurations: 

Email SMTP configurations are required to send the emails to the users by the SRDH Portal 
server. 

email.from= <SRDH admin email id> 
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email.smtphost=<Ma\\ Server SMTP Host Name> 
email.ip=<ma\\ server ip> 

Whenever users are created in SRDH application auto generated password will be sent to the 
user. 

email.subject=<P assword email subject> 

email.messageText = <Password Email Body> (Example:Dear Recipient,\n\nYour password is). 

Whenever one user is deleted from the SRDH application an email alert will be sent to the deleted 
user. 

email.subjectDeleteUser=<De\e\e User Email Subject> (Example:SRDH Account Deleted) 

email.messageTextDeleteUser = <Deleted User Email Body> (Example(Dear 
Recipient,\n\nYour Account has been deleted by the Administrator.) 

Whenever Self Resident User is registered in SRDH Application an auto generated OTP will be 
emailed to the Self Resident User. 

email.otp.subject=<Se\i Service OTP Email Subject> (Example: New OTP) 

emai.messageOtpText = <Self Service OTP Email Body> (Example:Dear Recipient,\n\nYour 
OTP is) 

3.1.8 Vault Server SFTP Configurations: 

Vault server is the one where all the EID-UID XML Files, Registrar Packets and KYR Packets are 
archived. 

SRDH Application will need SFTP connection to move the files for the archival. 

sftp.url = <SFTP Server IP> 

sftp.user= <SFTP User Name> 

sftp.password = <SFTP Password> 

sftp.port= <SFTP PORT> 
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3.1.9 Folder and File PathsConfigurations: 

3.1.9.1 EID-UID XML File Paths: 

Below folder has to be created in the server and configure them in properties file before deploying 
the application. 

filepath.encrypted = <root path >//encrypted 

(Encrypted EID-UID Files need to be copied in to this folder to upload to the SRDH Application) 
filepath.unencrypted =<root path >//unencrypted 

(Un-Encrypted EID-UID Files need to be copied in to this folder to upload to the SRDFi 
Application) 

filepath.failed = <root path >//failed 

(Failed EID-UID Files will be moved to this folder by the system) 
filepath.srdhtemp = <root pa\h>//srdhtemp 
(Application Temporary Folder) 
filepath.keys = <root path >//keys 

(Encryption & Decryption Keys and Certificates related files need to be copy in to this folder 
before deploying the war) 

filepath.xsd = <root path>//xscf 

(Enrollment XSD files need to be copy in to this folder before deploying the war) 


3.1.9.2 Seeding CSV File Paths: 

All the CSV folders are used by the application to store the Batch Seeding Uploaded Files. 

When user uploads the Batch Seeding CSV Template file through the application, fist it will 
uploads to csv//input folder. Seeding Batch Process picks the csv files from csv//input folder and 
processes it. Once a csv file is successfully processed, it will be moved to csv//processed folder. 
If a csv file is not processed successfully then it will be moved to csv//failed folder. 

Below folder has to be created in the server and configure them in properties file before deploying 
the application. 
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csv.filepath = <root path >//csv//input 
csv.processedfilepath = <root path >//csv//processed 
csv.failedfilepath = <root path >//csv//failed 
Note: Above CSV folder are used by the application. 

3.1.9.3 VAULT File Upload Paths: 

Below folders need to be created in SRDH Application server to upload the EID-UID XML Files, 
Registrar Packets and KYR Packets. From these folders files will be transferred to VAULT server 
through SFTP. Update location of folder appropriately. 

vault.fileupload.registrarpackets.path = <root path>// vaultupload//registrarpackets 
vault.fileupload.kyrpackets.path = <root path>// vaultupload // kyrpackets 
vault, fileupload.eiduidfiles.path = <root path>// vaultupload // eiduidfiles 
vault.filedownload.registrarpackets.path = <root path>// vaultdownload//registrarpackets 
vault.filedownload.kyrpackets.path = <root path>// vaultdownload//kyrpackets 
vault.filedownload.eiduidfiles.path = <root path>// vaultdownload//eiduidfiles 

3.1.9.4 SFTP VAULT Server Upload File Paths: 

Below folder structures should be exist in the Vault server to upload respective files, and update 
the property values accordingly. 

sftp.fileupload.registrarpackets.path=<SFJP Pa\h>//vaultupload//registrarpackets 
sftp.fileupload.kyrpackets.path = <SFTP Path>// vaultupload //kyrpackets 
sftp.fileupload.eiduidfiles.path = <SFT Path>// vaultupload //eiduidfiles 
sftp.filedownload.registrarpackets.path = <SFTP Pa\h>//vaultdownload//registrarpackets 
sftp.filedownload.kyrpackets.path = <SFTP Path>// vaultdownload//kyrpackets 
sftp.filedownload.eiduidfiles.path = <SFTP Path>// vaultdownload//eiduidfiles 
Note: Above folder structures need to be created in the Vault Server 
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3.1.10 Export Files Configurations 

Below parameters will define which are the columns need to be exported from various search 
results. 

search ExportParameters= uid, name, dobStr, address, gender, addrPincode 
Below are the available Search Export Parameters: 

uid, latestEid, name, dobStr, gender, addrCareof, addrBuilding, addrStreet, addrLandmark, 
addrLocality, addrVtcName, addrPoName, addrDistrictName, addrStateName, addrPincode, 
address, mobile, email. 

seedExportParameters=uid,name,dobStr,address,gender,addrPincode Below are 

the available Seeding Export Parameters from SRDH KYR Fields: departmentld, 

uniqueld,name, dobStr, address, gender, addrPincode, addrStateName, 

addrVtcName, addrCareof, addrBuilding, addrStreet, addrLandmark, addrLocality, addrPoName, 

addrDistrictName, mobile, email 

3.1.11 Query Builder Configuration Parameters: 

querybuilderresults.maxrows = 2000 

(This parameter is used to fetch the result set count from the external databases.) 

querybuilderresults.maxcols = 8 

(This parameters is used to show the no.of columns in the application, fetched from the external 
databases) 

Note: If we increase the no. of columns Ul alignments will not fit in the page size. 

querybuilder.datatype = varchar 

(Temporary Table Data Type) 

querybuilder.datatypecolumnsize = 250 

(Temporary Table columns size) 


3.2 authclient.properties Property File Configurations: 

Location: srdhportal.war->web-inf/classes/ 
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To get details of below parameters please go through Authentication API 1.6 documentation from 
UIDAI Portal. Below are the configurations of UIDAI test environment. 


usesBio= N 
useSSK= Y 
usesPfa= N 
usesP/'=N 
usesOtp= N 
usesP/'n=N 
usesPa=N 
usesBiollR= N 
usesBioFMR= N 
usesBioFIR=N 
useSyncKey = YES 
tokentype= 001 
tokennumber= 
version =1.6 
lov =560103 
/cfc=NA fdc= NC 
lattitude= 
longitude= 
pincode=560^03 
lot= P 

pidType= BOTH 

publiclP=-\ 27.0.0.1 

terminalld= public 

sa=public 

auaCode= public 

signa turePassword= public 

signa tureAlias= public 

ucfc=UIDAI\:SampleClient 

nameMatchingStrategy=<E/P> 

nameExactMatch Value= 100 

namePartialMatch Value=60 

addressMatchingStrategy=<E/P> 

addressExactMatch Value= 100 

addressPartialMatch Value= 60 

dobType=<MI A/D> 


(E-Exact Match P- Partial Match) 

(Value in Percentage) 

(Value in Percentage) 

(E-Exact Match P- Partial Match) 

(Value in Percentage) 

(Value in Percentage) 

(V-Verified, A-Approximate, D-Declared) 


//censeACeys=MC3GC07a7TT0meGKwxl2tVf7NVLMY+AQ2WhCbDgW4qYip0wVXdrXclg\= 


otpServerUrl =<OTP server URL> (Example : http\://auth.uidai.gov.in/otp/1.5) 
fcfcfServert/r/=<BFD server URL> (Example : http\://auth.uidai.gov.in/bfd/1.6) 
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authServerUrl=<AU/\ server URL> (Example : http\://localhost:8080/aua/auaservice/) 

publicKeyFile=<Key Location Path> (Example: //home//srdh//keys//uidai_auth_stage.cer) 
signKeyStore=< signKeyStore Location Path> (Example: //home//srdh//keys//public- 
may2012.p12) 
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3.3 Tables and Data Source Configurations: 


File Name: databaseResources.properties 

Location: srdhportal.war->web-inf/classes/ 


Below data sources are created for SRDH application to give flexibility to separate the tables in to 
multiple Servers or multiple schemas to increase the performance and share the data load. 

If all the tables are created in a single server/ schema, then all data sources will contain same 
values. 

Based on the state population we need to decide sharing of data in to various schemas and 
tables. 

For example Version History tables can contain 10 version of each enrollment in enrollment table. 
So this can be shared in to multiple database instances. 

Versions history tables are maintained based on starting number of the UID (1-9). 

And can be configured from 1 to 9 schemas based on the size of data. 

Before configuring this data sources in properties file. Please run the database scripts supplied 
with this release and create schemas and tables. Ensure all the scripts are executed successfully. 
After creating schemas provide the database details in property file as described below. 

Note: never specify root or any DB admin in any of the data source. Create some 
operational user in databases having permission of read/write/update/delete only. 

• databaseType= MYSQL 

databaseType property is used by the SRDH Application need to specify the database type. 
databaseType values can be MYSQL / ORACLE / MSSQL / DB2 (Values are case sensitive) 

• h/bernafe.d/a/ecf=org.hibernate.dialect.MySQLDialect 

We need to specify the dialect for hibernate based on the database type. 

Dialects for different databases: 

MySQL Dialect: org.hibernate.dialect.MySQLDialect 
MSSQL Dialect: org.hibernate.dialect.SQLServerDialect 
ORACLE Dialect: org.hibernate.dialect.OraclelOgDialect 
DB2 Dialect: org.hibernate.dialect.DB2Dialect 
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• hiberna te. show_ sg/=f a I s e 

hibernate.show_sql property is used to set the property to show hibernate generated 
SQL queries on console or not. 

True will show the SQL queries and false will not show the SQL queries on console. 

This feature is used to debug if any issues. 

Query Builder Driver and URL details for the different Databases. 

Query Builder Driver Name for My SQL. 
queryBuilderDataSourceMysqlDri ver= co m.mysql.jdbc.Driver 
Query Builder Driver URL for My SQL. 

queryBuilderDataSourceMysqlUrl=jdbc:mysql: 

Query Builder Driver Name for Oracle. 

£/ueryBu/7derDafaSourceOrac/eDr/Ver=oracle.jdbc.driver.OracleDriver 
Query Builder Driver URL for Oracle. 
queryBuilderDataSourceOracleUrl=\dbc.orac\e'.{h i n: 

Query Builder Driver Name for DB2 SQL. 

queryBuilderDataSourceDB2Dri ver= co m.ibm.db2.jcc.DB2Driver 
Query Builder Driver URL for DB2. 
queryBuilderDataSourceDB2Url=\ d be :d b2: 

Query Builder Driver Name for MS SQL. 

queryBu/7derDafaSourceMSSQZ.ServerDr/Ver=com.microsoft.sqlserver.jdbc.SQLServer 

Driver 

Query Builder Driver URL for MS SQL. 

queryBuilderDa taSourceMSSQL Server Url= j dbc:sqlserver: 


Sharding Configurations: 

This property indicates the number of sharding for the Enrollment Table. This property is 
mandatory and need to set the value carefully based on the enrollment sharding schemas. 

srdh.numberOfEnrollmentDataSource=<N u m be r> 

Example: srdh.numberOfEnrollmentDataSource= 9 

Below 9 properties defines which UID (Starting Number of UID) has to store in which 
shared enrollment schema. 
srdh.enrollmentUid.1=<Shared Schema Number> 
srdh.enrollmentUid.2=<Shared Schema Number> 
srdh.enrollmentUid.3=<Shared Schema Number> 
srdh.enrollmentUid.4=<Shared Schema Number> 
srdh.enrollmentUid.5=<Shared Schema Number> 
srdh.enrollmentUid.6=<Shared Schema Number> 
srdh.enrollmentUid.7=<Shared Schema Number> 
srdh.enrollmentUid.8=<Shared Schema Number> 

Example for 9 Shards: (Suggested for Population between 8-20 crores) 

srdh.numberOfEnrollmentDataSource=9 
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srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=2 

srdh.enrollmentUid.3=3 

srdh.enrollmentUid.4=4 

srdh.enrollmentUid.5=5 

srdh.enrollmentUid.6=6 

srdh.enrollmentUid.7=7 

srdh.enrollmentUid.8=8 

srdh.enrollmentUid.9=9 

Example for 4 Shards: (Suggested for Population between 4-8 crores) 

srdh.numberOfEnrollmentDataSource=4 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=1 

srdh.enrollmentUid.3=1 

srdh.enrollmentUid.4=2 

srdh.enrollmentUid.5=2 

srdh.enrollmentUid.6=3 

srdh.enrollmentUid.7=3 

srdh.enrollmentUid.8=4 

srdh.enrollmentUid.9=4 


Example for 2 Shards: (Suggested for Population between 2-4 crores) 

srdh.numberOfEnrollmentDataSource=2 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=1 

srdh.enrollmentUid.3=1 

srdh.enrollmentUid.4=1 

srdh.enrollmentUid.5=1 

srdh.enrollmentUid.6=2 

srdh.enrollmentUid.7=2 

srdh.enrollmentUid.8=2 

srdh.enrollmentUid.9=2 

Example for 1 Shard: (Suggested for Population between 0-2 crores) 

srdh.numberOfEnrollmentDataSource=1 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=1 

srdh.enrollmentUid.3=1 

srdh.enrollmentUid.4=1 

srdh.enrollmentUid.5=1 

srdh.enrollmentUid.6=1 

srdh.enrollmentUid.7=1 

srdh.enrollmentUid.8=1 

srdh.enrollmentUid.9=1 


Database Drivers: 
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MySQL Driver: com.mysql.jdbc.Driver 

Oracle Driver: oracle.jdbc.driver.OracleDriver 

MS SQL Driver: com.microsoft.sqlserver.jdbc.SQLServerDriver 

DB2 Driver: com.ibm.db2.jcc.DB2Driver 

Common Data Source configurations for the common tables: 

Common Tables: 

(audit_advanced_search, audit_search, audit_webservice_aua, audit_webservice_search, 
batch_enrollment, deactivate_reason, enrollment_rejection, ext_db_types, external_db, 
failure_reason, failure_reason_aua, language, permissions, process_status, rejection_reason, 
role, role_permission, self_service, srdhuser, system_parameters, user_query, vault_download, 
vault_upload,srdh_reports) 

commonDataSourceDriver=<Da\abase driver name> 
commonDataSourceUrl=<Da\a Source URL> 
commonDataSourceUsername=<Da\abase User Name> 
commonDataSourcePassword=ENC{<Eroryp\edi Database Password>) 
hibemate.defaultSchema.common=<Common Schema Name> 

Example: commonDataSourceDriver=com.mysql.jdbc. Driver 

commonDataSourceUrl=jdbc:mysql://1 27.0.0.1:3306/srdhcommon?useUnicode=yes&characterEn 
coding=UTF-8 

commonDataSourceUsername=root 

commonDataSourcePassword=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.common=srdhcommon 

Seeding Data Source configurations for the seeding tables: 

Seeding Tables: 

(seeding, seeding_batch, seeding_batch_input, seeding_batch_output, seeding_batch_temp, 
seeding_batch_weightage, seeding_department, seeding_dictionary) 

seedingDataSourceDriver=<Da\abase driver name> 
seedingDataSourceUrl=< Data Source URL> 
seedingDataSourceUsername=<Da\abase User Name> 
seedingDataSourcePassword=ENC(<Er\cryp\edi Database Password>) 
hibemate.defaultSchema.seeding=<See6\r\g Schema Name> 

Example: seedingDataSourceDriver=com.mysql.jdbc. Driver 

seeding DataSourceUrl=jdbc:mysql://1 27.0.0.1:3306/srdhseeding?useUnicode=yes&characterEnc 
oding=UTF-8 
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seeding DataSourceUsername=root 

seeding DataSourcePassword=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate.defaultSchema.seeding=srdhseeding 

QueryBuilder Data Source can be configured to Schema where the Temporary tables are 
created by the system. 

queryBuilderDataSourceDriver=<Da\abase driver name> 
queryBuilderDataSourceUrl==<Da\a Source URL> 
queryBuilderDataSourceUsername=<Da\abase User Name> 
queryBuilderDataSourcePassword= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.querybuilder=<Query Builder Schema Name> 

Example: queryBuilderDataSourceDriver=com.mysql.jdbc. Driver 

queryBuilderDataSourceUrl=jdbc:mysql://1 27.0.0.1:3306/srdhquerybuilder?useUnicode=yes&char 

acterEncoding=UTF-8 

queryBuilderDataSourceUsername=root 

queryBuilderDataSourcePassword=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

hibernate.defaultSchema.querybuilder=srdhquerybuilder 

Note: Based on no of shards, we need to create enrollment schemas in database and configure 
the data sources below accordingly. 

Enrollment Data Source configuration for the enrollment sharding schema One: 

enrollmentDataSourceDriver1=<Da\abase driver name> 
enrollmentDataSourceUrl1=<Da\a Source URL> 
enrollmentDataSourceUsername1=<Da\abase User Name> 
enrol I men tDa taSourcePass word 7=E N C (< E n c ry pt e d Database Password>) 
hiberna te. defaultSchema. enrol I men f7=<Enrollment Sharding First Schema Name> 

Example: enrollmentDataSourceDriverl =com.mysql.jdbc.Driver 

enrollmentDataSourceUrl1=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment1 ?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername1=root 

enrollmentDataSourcePassword1=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema. enrollment1=srdhenrollment1 

Enrollment Data Source configuration for the enrollment sharding schema Two: 

Note: This configuration is required only if you are using two or more shardings. 
enrollmentDataSourceDriver2=<Da\abase driver name> 
enrollmentDataSourceUrl2=<Da\a Source URL> 
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enrollmentDataSourceUsername2=<Da\abase User Name> 
enrollmentDataSourcePassword2= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment2=< Enrollment Sharding Second Schema Name > 

Example: enrollmentDataSourceDriver2=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl2=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment2?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername2=root 

enrollmentDataSourcePassword2=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment2=srdhenrollment2 


Enrollment Data Source configuration for the enrollment sharding schema Three: 

Note: This configuration is required only if you are using three or more shardings. 

enrollmentDataSourceDriver3=<Da\abase driver name> 
enrollmentDataSourceUrl3=<Da\a Source URL> 
enrollmentDataSourceUsername3=<Da\abase User Name> 
enrollmentDataSourcePassword3= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment3=< Enrollment Sharding Third Schema Name > 

Example: enrollmentDataSourceDriver3=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl3=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment3?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername3=root 

enrollmentDataSourcePassword3=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment3=srdhenrollment3 

Enrollment Data Source configuration for the enrollment sharding schema Four: 

Note: This configuration is required only if you are using four or more shardings. 

enrollmentDataSourceDriver4=<Da\abase driver name> 
enrollmentDataSourceUrl4=<Da\a Source URL> 
enrollmentDataSourceUsername4=<Da\abase User Name> 
enrollmentDataSourcePassword4= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment4=< Enrollment Sharding Forth Schema Name > 

Example: enrollmentDataSourceDriver4=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl4=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment4?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername4=root 
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enrollmentDataSourcePassword4=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment4=srdhenrollment4 

Enrollment Data Source configuration for the enrollment sharding schema Five: 

Note: This configuration is required only if you are using five or more shardings. 

enrollmentDataSourceDriver5=<Da\abase driver name> 
enrollmentDataSourceUrl5=<Da\a Source URL> 
enrollmentDataSourceUsername5=<Da\abase User Name> 
enrollmentDataSourcePassword5= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment5=< Enrollment Sharding Fifth Schema Name > 

Example: enrollmentDataSourceDriver5=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl5=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment5?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername5=root 

enrollmentDataSourcePassword5=ENC(8gn+TzYX10XmoYFIZ9hjX7A==) 
hibernate. defaultSchema.enrollment5=srdhenrollment5 

Enrollment Data Source configuration for the enrollment sharding schema Six: 

Note: This configuration is required only if you are using six or more shardings. 

enrollmentDataSourceDriver6=<Da\abase driver name> 
enrollmentDataSourceUrl6=<Da\a Source URL> 
enrollmentDataSourceUsername6=<Da\abase User Name> 
enrollmentDataSourcePassword6= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment6=< Enrollment Sharding Sixth Schema Name > 

Example: enrollmentDataSourceDriver6=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl6=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment6?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername6=root 

enrollmentDataSourcePassword6=ENC(8gn+TzYX10XmoYFlZ9hjX7A==) 
hibernate. defaultSchema.enrollment6=srdhenrollment6 

Enrollment Data Source configuration for the enrollment sharding schema Seven: 

Note: This configuration is required only if you are using seven or more shardings. 

enrollmentDataSourceDriver7=<Da\abase driver name> 
enrollmentDataSourceUrl7=<Da\a Source URL> 
enrollmentDataSourceUsername7=<Da\abase User Name> 
enrollmentDataSourcePassword7= E NC (< E ncry pted Database Password>) 
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hibernate.defaultSchema.enrollment7=< Enrollment Sharding Seventh Schema Name > 
Example: enrollmentDataSourceDriver7=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl7=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment7?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername7=root 

enrollmentDataSourcePassword7=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment7=srdhenrollment7 

Enrollment Data Source configuration for the enrollment sharding schema Eight: 

Note: This configuration is required only if you are using eight or more shardings. 

enrollmentDataSourceDriver8=<Da\abase driver name> 
enrollmentDataSourceUrl8=<Da\a Source URL> 
enrollmentDataSourceUsername8=<Da\abase User Name> 
enrollmentDataSourcePassword8= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment8=< Enrollment Sharding Eighth Schema Name > 

Example: enrollmentDataSourceDriver8=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl8=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment8?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername8=root 

enrollmentDataSourcePassword8=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment8=srdhenrollment8 

Enrollment Data Source configuration for the enrollment sharding schema Nine. 

Note: This configuration is required only if you are using nine shardings. 

enrollmentDataSourceDriver9=<Da\abase driver name> 
enrollmentDataSourceUrl9=<Da\a Source URL> 
enrollmentDataSourceUsername9=<Da\abase User Name> 
enrollmentDataSourcePassword9= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment9=< Enrollment Sharding Ninth Schema Name > 

Example: enrollmentDataSourceDriver9=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl9=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment9?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername9=root 

enrollmentDataSourcePassword9=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment9=srdhenrollment9 
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Version History Data Source Configurations: 

SRDH Application will provide version history data can be shared in to 1 to 9 shardings. 

Below mentioned all the version history data sources are mandatory. 

If administrator wants to configure all the version histories in to one schema, then needs to 
configure same schema name for all the 9 version history data sources. 

If administrator wants to shared in to 2 schemas then needs to configure 1-5 data sources one 
schema name and 6-9 data sources another schema name. 

Same will be repeated based on no. of version history shardings. 

versionHistoryDa taSourceDri ver 7=<D at abase driver name> 
versionHistoryDataSourceUrl1==< Data Source URL> 
versionHistoryDataSourceUsername1=<Da\abase User Name> 
versionHistoryDataSourcePassword1=ENC{<Encryp\eb Database Password>) 
hibernate.defaultSchema.versionhistory1=<\l exs\on History Schema Name> 

Example: versionHistoryDataSourceDriverl =com.mysql.jdbc.Driver 

versionHistoryDataSourceUrl1=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh1 ?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername1=root 

versionHistoryDataSourcePassword1=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

hibernate.defaultSchema.versionhistory1=srdhenrollmentvh1 

versionHistoryDataSourceDriver2=<Da\abase driver name> 
versionHistoryDataSourceUrl2=<Da\a Source URL> 
versionHistoryDataSourceUsername2= <Database User Name> 
versionHistoryDataSourcePassword2=ENC(<Encryp{ed Database Password>) 
hibernate.defaultSchema.versionhistory2=<\! e\s\ on History Schema Name> 

Example: versionHistoryDataSourceDriver2=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl2=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh2?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername2=root 

versionHistoryDataSourcePassword2=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate.defaultSchema. versionhistory2=srdhenrollmentvh2 

versionHistoryDataSourceDriver3=< Database driver name> 
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versionHistoryDataSourceUrl3= <Data Source URL> 
versionHistoryDataSourceUsemame3= <Database User Name> 
versionHistoryDataSourcePassword3=ENC(<Encryp\eci Database Password>) 
hibernate.defaultSchema.versionhistory3=<\/ers\on History Schema Name> 

Example: versionHistoryDataSourceDriver3=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl3=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh3?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername3=root 

versionHistoryDataSourcePassword3=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.versionhistory3=srdhenrollmentvh3 

versionHistoryDataSourceDriver4=<Da\abase driver name> 
versionHistoryDataSourceUrl4=< Data Source URL> 
versionHistoryDa ta Source Username4= <Database User Name> 
versionHistoryDataSourcePassword4=ENC(<Encryp\edi Database Password>) 
hibernate.defaultSchema.versionhistory4=<\/ers\ori History Schema Name> 

Example: versionHistoryDataSourceDriver4=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl4=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh4?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername4=root 

versionHistoryDataSourcePassword4=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.versionhistory4=srdhenrollmentvh4 


versionHistoryDataSourceDriver5=<Da\abase driver name> 
versionHistoryDa taSource Url5= < Data Source URL> 
versionHistoryDa ta Source Username5= <Database User Name> 
versionHistoryDataSourcePassword5=ENC(<Encryp\edi Database Password>) 
hibernate.defauitSchema.versionhistory5=<ye\s\or History Schema Name> 

Example: versionHistoryDataSourceDriver5=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl5=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh5?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername5=root 

versionHistoryDataSourcePassword5=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.versionhistory5=srdhenrollmentvh5 


versionHistoryDataSourceDriver6=< Database driver name> 
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versionHistoryDataSourceUrl6=<Da\a Source URL> 
versionHistoryDataSourceUsername6= <Database User Name> 
versionHistoryDataSourcePassword6=ENC(<Encryp\eci Database Password>) 
hibernate.defaultSchema.versionhistory6=<\/ers\on History Schema Name> 

Example: versionHistoryDataSourceDriver6=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl6=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh6?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername6=root 

versionHistoryDataSourcePassword6=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.versionhistory6=srdhenrollmentvh6 


versionHistoryDataSourceDriver7=<Da\abase driver name> 
versionHistoryDataSourceUrl7=<Da\a Source URL> 
versionHistoryDataSourceUsername7=<Da\abase User Name> 
versionHistoryDataSourcePassword7=ENC(<Encryp\eb Database Password>) 
hibernate.defaultSchema.versionhistory7=<\l exs\or History Schema Name> 

Example: versionHistoryDataSourceDriver7=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl7=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh7?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername7=root 

versionHistoryDataSourcePassword7=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.versionhistory7=srdhenrollmentvh7 


versionHistoryDataSourceDriver8=<Da\abase driver name> 
versionHistoryDataSourceUrl8==< Data Source URL> 
versionHistoryDa ta Source Usemame8= <Database User Name> 
versionHistoryDataSourcePassword8=ENC(<Encryp{e6 Database Password>) 
hibernate.defauitSchema.versionhistory8=<ye\s\oa History Schema Name> 

Example: versionHistoryDataSourceDriver8=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl8=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh8?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername8=root 

versionHistoryDataSourcePassword8=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.versionhistory8=srdhenrollmentvh8 
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versionHistoryDataSourceDriver9=< Database driver name> 
versionHistoryDataSourceUrl9=<Da\a Source URL> 
versionHistoryDataSourceUsemame9=<Da\abase User Name> 
versionHistoryDataSourcePassword9= ENC(<Encrypted Database Password>) 
hibernate.defau!tSchema.versionhistory9=<ye\s\ou History Schema Name> 

Example: versionHistoryDataSourceDriver9=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl9=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh9?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername9=root 

versionHistoryDataSourcePassword9=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.versionhistory9=srdhenrollmentvh9 


3.3.1 MASTER TABLES AND DATA: 


3.3.1.ITable: language 

language table is used to store all the language details for the SRDH application. 

Please run the given master data insert scripts in database before deploying the application. 
Make sure local language is configured as per given instructions. 


3.3.1.2Table: permissions 


permissions table contains all the user permissions, of the SRDH application. 
Please run below insert scripts in database before deploying the application. 


3.3.1.3Table: role 


role table contains all the roles of the SRDH users. 

Please run given insert scripts in database before deploying the application. 

While creating role table first row has to be Administrator. This is mandatory. 

(In application first row (Administrator Role) was not fetching due to security reasons. SRDH 
users are not allowed to modify Administrator Role Permissions). 
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3.3.1.4Table: role_permission 


role_permission table is the join table between role and permissions tables. 
Please run given insert scripts in database before deploying the application. 


3.3.1.5Table: srdhuser 


srdhuser table contains all the SRDH users information. 

Please run given insert scripts in database before deploying the application. 

First row of this table has to be the Administrator. 

Since SRDH users are not allowed to modify Administrator user information. So first row will not 
be fetched and displayed in the application. 


3.3.1.6Table: deactivate_reason 

deactivate_reason table is used to store the deactivate reasons for the enrollments. 

Below Deactivate reasons are given for example. These reason codes and descriptions need to 
be modified according to State Specific Reasons. 

Please run given insert scripts in database before deploying the application. 


3.3.1.7Table: rejection_reason 


rejection_reason table is used to store all the rejection reasons for the EID UID XML files during 
upload the data from EID UID XML files by the XML Batch Process. 

Some of the below reasons will come along with EID UID XML file and some of the reasons are 
used by the SRDH applications. 

Please run given insert scripts in database before deploying the application. 


3.3.1.8Table: process_status 
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process_status table is used to set the running status of Seeding and XML Batch processes. 

In this table 'XML_BATCH_PROCESSING’ and , CSV_BATCH_SEEDING’ entries are mandatory 
and set the status value to ‘N’. 

Please run given insert scripts in database before deploying the application. 


3.3.1.9Table: seeding_dictionary 

seeding_dictionary is used to 


3.3.1.10 Table: ext_db_types 

ext_db_types table is used for Query Builder to connect the external databases. 

This is the master table for external database types. 

Currently SRDH Application supports 4 Types of databases (MySql, MS Sql, Oracle and DB2). 

In this table there are two columns. 

1) Ext_db_type_id : This column contains the Database Type ID. These values have to be 
as it is as mentioned in below insert script. These values should not change. Because 
these values are used in the code. 

2) Ext_db_type: This column contains the description of database and will be displayed in 
the screen. 


Please run given insert scripts in database before deploying the application. 


3.4 Web.xml File 

Location: srdhportal.war->web-inf 


To set the Session timeout for the SRDH application need to the set the session-timeout value 
(minutes) in web.xml file. 

<session-config> 

<session-timeout>10</session-timeout> 

</session-config> 


3.5 applicationContext.xml Changes: 
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In applicationContext.xml file we need to enable properties for all the session factories based on 
the no of shardings. 

Based on no.of shardings need to un-comment the enrollmentDataSources and 
enrollmentSessionFactories. Given instructions in applicationContext.xml file. 

In below bean tag you need to un-comment (Yellow Marked) enrollmentSessionFactories based 
on no.of. shardings. 

In all bean tags for the datasources you need to add the below (Green Marked) 
properties 


<bean id="commonDataSource" class="org.apache.commons.dbcp.BasicDataSource"> 

<property name="driverClassName" value="${commonDataSourceDriver}" /> 

<property name="url" value="${commonDataSourceUrl}" /> 

<property name="username" value="${commonDataSourceUsername}" /> 

<property name="password" value="${commonDataSourcePassword}" /> 

<property name="initialSize" value="2"/> 

<property name="maxActive" value="300"/> 

<property name="maxldle" value="50"/> 

<property name="minldle" value="10"/> 

<property name="maxWait" value="10000"/> 

<property name ="minEvictableldleTimeMillis" value="30000"/> 

<property name ="validationQuery" value="select 1 from dual"/> 

</bean> 

<bean id="dbController" class="in.gov.uidai.srdh.batch.xmlprocessor.util.DbControllerUtil"> 
<property name="commonSessionFactory" ref="commonSessionFactory" /> 

<property name="enrollmentSessionFactory1" ref="enrollmentSessionFactory1" /> 
<property name="enrollmentSessionFactory2" ref="enrollmentSessionFactory2" /> 
<property name="enrollmentSessionFactory3" ref="enrollmentSessionFactory3" /> 
<property name="enrollmentSessionFactory4" ref="enrollmentSessionFactory4" /> 

<property name="enrollmentSessionFactory5" ref="enrollmentSessionFactory5" /> 
<property name="enrollmentSessionFactory6" ref="enrollmentSessionFactory6" /> 
<property name="enrollmentSessionFactory7" ref="enrollmentSessionFactory7" /> 
<property name="enrollmentSessionFactory8" ref="enrollmentSessionFactory8" /> 

<property name="enrollmentSessionFactory9" ref="enrollmentSessionFactory9" /> 


<property name="versionFHstorySessionFactory1" ref="versionFlistorySessionFactory1" /> 
<property name="versionFlistorySessionFactory2" ref="versionFlistorySessionFactory2" /> 
<property name="versionFlistorySessionFactory3" ref="versionFlistorySessionFactory3" /> 
<property name="versionFlistorySessionFactory4" ref="versionFlistorySessionFactory4" /> 
<property name="versionFlistorySessionFactory5" ref="versionFlistorySessionFactory5" /> 
<property name="versionFlistorySessionFactory6" ref="versionFlistorySessionFactory6" /> 
<property name="versionFlistorySessionFactory7" ref="versionFlistorySessionFactory7" /> 
<property name="versionFlistorySessionFactory8" ref="versionFlistorySessionFactory8" /> 
<property name="versionFlistorySessionFactory9" ref="versionFlistorySessionFactory9" /> 
</bean> 
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3.6 Log4j.xml 

Location: srdhportal.war->web-inf/classes/ 

To set the application log file location need to set the property in log4j.xml file. 


<param name="file" value="<root path>/logs/srdhapplication.log"/> 


3.7 Code changes 


Location: srdhportal.war^ln all the DAO where the new hibernate DB sessions are created. 
To replace session.close(); in the finally block with the below finally block 


finally{ 


} 


if(null!=session) 

{ 

session.close(); 

} 
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4 Search Service war Deployment 

Note: Maharashtra state has its own search services deployed. The search service provided by Mahindra 
Satyam is not used 

searchservice.war needs to be deployed in application server. 

Files need to be configured: 

1. databaseResources.properties 

2. applicationContext.xml 

3. Log4j.xml 


4.1 DatabaseResources.properties 

Location: searchservice.war^web-inf/classes/ 

Configure the Maximum search results. 

• search.maxresults=1 00 

• hiberna te. dialect= org.hibernate.dialect.MySQLDialect 

We need to specify the dialect for hibernate based on the database type. 

Dialects for different databases: 

MySQL Dialect: org.hibernate.dialect.MySQLDialect 
MSSQL Dialect: org.hibernate.dialect.SQLServerDialect 
ORACLE Dialect: org.hibernate.dialect.OraclelOgDialect 
DB2 Dialect: org.hibernate.dialect.DB2Dialect 

• hiberna te. show_ sql=i a I s e 

hibernate.show_sql property is used to set the property to show hibernate generated 
SQL queries on console or not. 

True will show the SQL queries and false will not show the SQL queries on console. 

This feature is used to debug if any issues. 

Sharding Configurations: 

This property indicates the number of sharding for the Enrollment Table. This property is 
mandatory and need to set the value carefully based on the enrollment sharding schemas. 
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Note: Sharding properties should be configured same as defined for SRDH Portal 
above. 


srdh.numberOfEnrollmentDataSource=<H u m be r> 

Example: srdh.numberOfEnrollmentDataSource=9 

Below 9 properties defines which UID (Starting Number of UID) has to store in which 
shared enrollment schema. 
srdh.enrollmentUid.1=<Shared Schema Number> 
srdh.enrollmentUid.2=<Shared Schema Number> 
srdh.enrollmentUid.3=<Shared Schema Number> 
srdh.enrollmentUid.4=<Shared Schema Number> 
srdh.enrollmentUid.5=<Shared Schema Number> 
srdh.enrollmentUid.6=<Shared Schema Number> 
srdh.enrollmentUid.7=<Shared Schema Number> 
srdh.enrollmentUid.8=<Shared Schema Number> 

Example for 9 Shards: (Suggested for Population between 8-20 crores) 

srdh.numberOfEnrollmentDataSource=9 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=2 

srdh.enrollmentUid.3=3 

srdh.enrollmentUid.4=4 

srdh.enrollmentUid.5=5 

srdh.enrollmentUid.6=6 

srdh.enrollmentUid.7=7 

srdh.enrollmentUid.8=8 

srdh.enrollmentUid.9=9 

Example for 4 Shards: (Suggested for Population between 4-8 crores) 

srdh.numberOfEnrollmentDataSource=4 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=1 

srdh.enrollmentUid.3=1 

srdh.enrollmentUid.4=2 

srdh.enrollmentUid.5=2 

srdh.enrollmentUid.6=3 

srdh.enrollmentUid.7=3 

srdh.enrollmentUid.8=4 

srdh.enrollmentUid.9=4 


Example for 2 Shards: (Suggested for Population between 2-4 crores) 

srdh.numberOfEnrollmentDataSource=2 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=1 

srdh.enrollmentUid.3=1 

srdh.enrollmentUid.4=1 
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srdh.enrollmentUid.5=1 

srdh.enrollmentUid.6=2 

srdh.enrollmentUid.7=2 

srdh.enrollmentUid.8=2 

srdh.enrollmentUid.9=2 

Example for 1 Shard: (Suggested for Population between 0-2 crores) 

srdh.numberOfEnrollmentDataSource=1 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=1 

srdh.enrollmentUid.3=1 

srdh.enrollmentUid.4=1 

srdh.enrollmentUid.5=1 

srdh.enrollmentUid.6=1 

srdh.enrollmentUid.7=1 

srdh.enrollmentUid.8=1 

srdh.enrollmentUid.9=1 


Database Drivers: 

MySQL Driver: com.mysql.jdbc.Driver 

Oracle Driver: oracle.jdbc.driver.OracleDriver 

MS SQL Driver: com.microsoft.sqlserver.jdbc.SQLServerDriver 

DB2 Driver: com.ibm.db2.jcc.DB2Driver 

Common Data Source configuration: 

commonDataSourceDriver=<Database driver name> 
commonDataSourceUrl=<Da\a Source URL> 
commonDataSourceUsername=<Da\abase User Name> 
commonDataSourcePassword=ENC{<Enoryp\edi Database Password>) 
hibemate.defaultSchema.common=<Commor\ Schema Name> 

Example: commonDataSourceDriver=com.mysql.jdbc. Driver 

commonDataSourceUrl=jdbc:mysql://1 27.0.0.1:3306/srdhcommon?useUnicode=yes&characterEn 
coding=UTF-8 

commonDataSourceUsername=root 

commonDataSourcePassword=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.common=srdhcommon 


Note: Based on no of shards, we need to create enrollment schemas in database and configure 
the data sources below accordingly. 
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Enrollment Data Source configuration for the enrollment sharding schema One: 

enrollmentDataSourceDriver1=<Da\abase driver name> 
enrollmentDataSourceUrl1=<Da\a Source URL> 
enrollmentDataSourceUsername 7=<Database User Name> 
enrollmentDataSourcePassword1= ENC(<Encrypted Database Password>) 
hiberna te. defaultSchema. enrollment1=< E n ro 11 m e n t Sharding First Schema Name> 

Example: enrollmentDataSourceDriverl =com.mysql.jdbc.Driver 

enrollmentDataSourceUrl1=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment1 ?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername1=root 

enrollmentDataSourcePassword1=ENC(8gn+TzYX10XmoYFIZ9hjX7A==) 
hibernate. defaultSchema. enrollment1=srdhenrollment1 

Enrollment Data Source configuration for the enrollment sharding schema Two: 

Note: This configuration is required only if you are using two or more shardings. 

enrol I men tDa taSourceDri ver2= <Database driver name> 
enrollmentDataSourceUrl2=<Da\a Source URL> 
enrollmentDataSourceUsername2=<Da\abase User Name> 
enrollmentDataSourcePassword2= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment2=< Enrollment Sharding Second Schema Name > 

Example: enrollmentDataSourceDriver2=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl2=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment2?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername2=root 

enrollmentDataSourcePassword2=ENC(8gn+TzYX10XmoYFIZ9hjX7A==) 
hibernate.defaultSchema. enrollment2=srdhenrollment2 


Enrollment Data Source configuration for the enrollment sharding schema Three: 
Note: This configuration is required only if you are using three or more shardings. 

enrol I men tDa taSourceDri ver3= <Database driver name> 
enrollmentDataSourceUrl3=<Da\a Source URL> 
enrollmentDataSourceUsername3=<Da\abase User Name> 
enrol I men tDa taSourcePass word3= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment3=< Enrollment Sharding Third Schema Name > 
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Example: enrollmentDataSourceDriver3=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl3=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment3?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername3=root 

enrollmentDataSourcePassword3=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment3=srdhenrollment3 

Enrollment Data Source configuration for the enrollment sharding schema Four: 

Note: This configuration is required only if you are using four or more shardings. 

enrol I men tDa taSourceDri ver4= <Database driver name> 
enrollmentDataSourceUrl4=<Da\a Source URL> 
enrollmentDataSourceUsername4=<Da\abase User Name> 
enrollmentDataSourcePassword4= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment4=< Enrollment Sharding Forth Schema Name > 

Example: enrollmentDataSourceDriver4=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl4=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment4?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername4=root 

enrollmentDataSourcePassword4=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment4=srdhenrollment4 

Enrollment Data Source configuration for the enrollment sharding schema Five: 

Note: This configuration is required only if you are using five or more shardings. 

enrol I men tDa taSourceDri ver5= <Database driver name> 
enrollmentDataSourceUrl5=<Da\a Source URL> 
enrollmentDataSourceUsername5=<Da\abase User Name> 
enrollmentDataSourcePassword5= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment5=< Enrollment Sharding Fifth Schema Name > 

Example: enrollmentDataSourceDriver5=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl5=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment5?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername5=root 

enrollmentDataSourcePassword5=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment5=srdhenrollment5 

Enrollment Data Source configuration for the enrollment sharding schema Six: 

Note: This configuration is required only if you are using six or more shardings. 
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enrollmentDataSourceDriver6=<Da\abase driver name> 
enrollmentDataSourceUrl6=<Da\a Source URL> 
enrollmentDataSourceUsername6=<Da\abase User Name> 
enrollmentDataSourcePassword6= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment6=< Enrollment Sharding Sixth Schema Name > 

Example: enrollmentDataSourceDriver6=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl6=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment6?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername6=root 

enrollmentDataSourcePassword6=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment6=srdhenrollment6 

Enrollment Data Source configuration for the enrollment sharding schema Seven: 

Note: This configuration is required only if you are using seven or more shardings. 

enrollmentDataSourceDriver7=<Da\abase driver name> 
enrollmentDataSourceUrl7=<Da\a Source URL> 
enrollmentDataSourceUsername7=<Da\abase User Name> 
enrollmentDataSourcePassword7= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment7=< Enrollment Sharding Seventh Schema Name > 

Example: enrollmentDataSourceDriver7=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl7=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment7?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername7=root 

enrollmentDataSourcePassword7=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment7=srdhenrollment7 

Enrollment Data Source configuration for the enrollment sharding schema Eight: 

Note: This configuration is required only if you are using eight or more shardings. 

enrollmentDataSourceDriver8=<Da\abase driver name> 
enrollmentDataSourceUrl8=<Da\a Source URL> 
enrollmentDataSourceUsername8=<Da\abase User Name> 
enrollmentDataSourcePassword8= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment8=< Enrollment Sharding Eighth Schema Name > 

Example: 

enrollmentDataSourceDriver8=com.mysql.jdbc. Driver 
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enrollmentDataSourceUrl8=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment8?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername8=root 

enrollmentDataSourcePassword8=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment8=srdhenrollment8 

Enrollment Data Source configuration for the enrollment sharding schema Nine. 

Note: This configuration is required only if you are using nine shardings. 

enrollmentDataSourceDriver9=<Da\abase driver name> 
enrollmentDataSourceUrl9=<Da\a Source URL> 
enrollmentDataSourceUsername9=<Da\abase User Name> 
enrollmentDataSourcePassword9= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment9=< Enrollment Sharding Ninth Schema Name > 

Example: enrollmentDataSourceDriver9=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl9=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment9?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername9=root 

enrollmentDataSourcePassword9=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment9=srdhenrollment9 


4.1 applicationContext.xml Changes: 


In applicationContext.xml file we need to enable properties for all the session factories based on 
the no of shardings. 

Based on no.of shardings need to un-comment the enrollmentDataSources and 
enrollmentSessionFactories. Given instructions in applicationContext.xml file. 

In below bean tag you need to un-comment (Yellow Marked) enrollmentSessionFactories based 
on no.of. shardings. 

<bean id="dbController" class="in.gov.uidai.srdh.batch.xmlprocessor.util.DbControllerUtil"> 
<property name="commonSessionFactory" ref="commonSessionFactory" /> 

<property name="enrollmentSessionFactory1" ref="enrollmentSessionFactory1" /> 
<property name="enrollmentSessionFactory2" ref="enrollmentSessionFactory2" /> 
<property name="enrollmentSessionFactory3" ref="enrollmentSessionFactory3" /> 
<property name="enrollmentSessionFactory4" ref="enrollmentSessionFactory4" /> 

<property name="enrollmentSessionFactory5" ref="enrollmentSessionFactory5" /> 
<property name="enrollmentSessionFactory6" ref="enrollmentSessionFactory6" /> 
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<property name="enrollmentSessionFactory7" ref="enrollmentSessionFactory7" /> 
<property name="enrollmentSessionFactory8" ref="enrollmentSessionFactory8" /> 

<property name="enrollmentSessionFactory9" ref="enrollmentSessionFactory9" /> 

<property name="versionFlistorySessionFactory1" ref="versionFlistorySessionFactory1" /> 
<property name="versionFlistorySessionFactory2" ref="versionFlistorySessionFactory2" /> 
<property name="versionFlistorySessionFactory3" ref="versionFlistorySessionFactory3" /> 
<property name="versionFlistorySessionFactory4" ref="versionFlistorySessionFactory4" /> 
<property name="versionFlistorySessionFactory5" ref="versionFlistorySessionFactory5" /> 
<property name="versionFlistorySessionFactory6" ref="versionFlistorySessionFactory6" /> 
<property name="versionFlistorySessionFactory7" ref="versionFlistorySessionFactory7" /> 
<property name="versionFlistorySessionFactory8" ref="versionFlistorySessionFactory8" /> 
<property name="versionFlistorySessionFactory9" ref="versionFlistorySessionFactory9" /> 
</bean> 


4.2 Log4j.xml 

To set the application log file location need to set the property in log4j.xml file. 


<param name="file" value="<root path>/logs/searchservice.log"/> 
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5 AUA Server war Deployment 


aua.war needs to be deployed in application server. 

Items provided with the SRDH package for AUA Server: 

1 aua.war 

2 bcprov-jdk16-140.jar 

3 bouncycastle (folder) 


5.1 Environmental Pre-requisites 

Step: 1 

Locate JRE in the system. In jre\lib\security the java.security file will be there in that file need to add the 
security provider for the BouncyCastleProvider. 

JRE Location: <java root path>\jdkl.6.0_26\jre\lib\security\java.security 

security, provider. l=sun.security, provider.Sun 
security, provider.2=sun.security. rsa.SunRsaSign 
security, provider. 3=com. sun. net. ssl. internal, ssl. Provider 
security, provider.4=com.sun.crypto, provider.SunJCE 
security.provider.5=sun.security.jgss.SunProvider 
security, provider. 6=com. sun. security, sasl. Provider 
security, provider. 7=org.jcp.xml.dsig.internal.dom.XMLDSigRI 
security, provider.8=sun.security.smartcardio.SunPCSC 
security, provider. 9=sun.security.mscapi.SunMSCAPI 

security.provider.10=org.bouncycastle.jce.provider.BouncyCastleProvider (Need to add this line in 
java.security file) 

Step: 2 

Need to copy the bcprov-jdkl6-140.jar in jre/lib/ext folder. 

Location: <java root path>\jdkl.6.0_26\jre\lib\ext 

File: bcprov-jdkl6-140.jar (Need to copy this jar in to above location. This jar was provided with the SRDH 
package) 
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Step: 3 

Need to copy the' bouncycastle' folder in to jboss modules. 
Location: <jboss root path>jboss-as-web-7.0.2.Final\modules\org 


Need to copy the ' bouncycastle' folder in to above location. This bouncycastle folder was provided 
with the SRDH package. 

Step: 4 

Need to add below lines in jboss standalone. xml. 

Location: <jobss root path> jboss-as-web-7.0.2.Final\standalone\configuration\standalone.xml 
subsystem xmlns="urn:jboss:domain:ee:1.0"> 

<global-modules> 

<module name="org.bouncycastle.jce.provider" slot="main"/> 


</global-modules> 


</subsystem> 

Add the yellow marked lines in the subsystem xmlns="urn:jboss:domain:ee:1.0"> tag. 


Files need to be configured: 

1. DatabaseResources.properties 

2. aua.properties 

3. ApplicationContext.xml 

4. Log4j.xml 


5.2 databaseResources.properties 

Location: aua.war->web-inf/classes/ 

Configure the Database details in database resource in property file. 

commonDataSourceDriver=<Database driver name> 
commonDataSourceUrl=<Da\a Source URL> 
commonDataSourceUsername=<Da\abase User Name> 
commonDataSourcePassword=<Da\abase Password> 

Example: 
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commonDataSourceDriver= com.mysql.jdbc. Driver 
commonDataSourceUrl= jdbc:mysql://127.0.0.1:3306/srdhcommon 
commonDataSourceUsername= root 
commonDataSourcePassword= password 

Database Drivers: 

MySQL Driver: com.mysql.jdbc.Driver 

Oracle Driver: oracle.jdbc.driver.OracleDriver 

MS SQL Driver: com.microsoft.sqlserver.jdbc.SQLServerDriver 

DB2 Driver: com.ibm.db2.jcc.DB2Driver 


hibernate.dialect = <Dialect Name> 

We need to specify the dialect for hibernate based on the database type. 

Dialects for different databases: 

MySQL Dialect: org.hibernate.dialect.MySQLDialect 
MSSQL Dialect: org.hibernate.dialect.SQLServerDialect 
ORACLE Dialect: org.hibernate.dialect.OraclelOgDialect 
DB2 Dialect: org.hibernate.dialect.DB2Dialect 

hibernate.show_sql=ia\se 

hibernate.show_sql property is used to set the property to show hibernate generated SQL 
queries on console or not. 

True will show the SQL queries and false will not show the SQL queries on console. 

This feature is used to debug if any issues. 


hibernate.defaultSchema=<Schema Name> 
Example: hibernate. defaultSchema=srdhcommon 

5.3 aua.properties 


authServerUrl /'sthe URL where the actual CIDR authentication server is running. 

authServerUrl = http\://auth.uidai.gov.in/1.6 

otpServerUrl /'sthe URL where the actual CIDR otp server is running. 

olpServer\Jr\=http\://auth.uidai.gov.in/otp/1.5 
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bfdServerUrl is the URL where the actual CIDR bfd server is running. 

bfdServer U rl =http 1 ://auth. uidai.gov.in/bfd/1.6 

licenseKey=MKg8njN60+QRUm YF+ TrbBUCqlrCnbN/Ns6h YbnnaOk99e5UGNhhE/xQ= (This 
is test license Key, CIDR will provide license key once state registered as AUA) 

asaLicenseKey=MMZS5K8bEkG WFQe6y_ruBu9tFR2yQFQkqmECCpp9veRawhue 1 oGpa4s{ 

This is ASA license Key, CIDR will provide license key once state registered as AUA) 

isASA = false(Flag to check whether ASA is configured or not) 
isHsm = false(Flag to check whether HSM is configured or not) 

If HSM is configured provide the following three attributes: 

certificateAlias = 
hsmPassword = 
privateKeyAlias= 

auaCode = public (This code will be provided by the CIDR after state registered as AUA). 

terminalld = public 

transactionldentifier=AuthDemoClient (This transaction identifier value will be provided by 
CIDR) 


signKeyStore=<root path>//keys//public-may2012.p12 (Key Store will be provided by the CIDR 
after registered as AUA. Need to copy the key store file in the above location) 

publicKeyFileDSIG =<root path>//keys//Auth_Staging.cer{public Key File for Digital Signing. 
Need to copy the file in the above location) 

signatureAlias=public (Default value is public, if any changes CIDR will provide). 

signaturePassword=public (Default value is public, if any changes, CIDR will provide the 
password after registered as AUA) 
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The following uses attributes are to be configured when uses element is empty. 

usesPfa = Y7A/(The value is "y" if element "Pfa" (part of "Demo" element) used in 
authentication) 

usesPi = y/A/(The value is "y" if at least one attribute of element "Pi" (part of "Demo" 
element) used in authentication) 

usesOtp = Y7A/(The value is "y" if OTP used in authentication) 
usesPin = V7A/(The value is "y" if PIN used in authentication) 

usesPa = Y/NfYhe value is "y" if at least one attribute of element "Pa" (part of "Demo" 
element) used in authentication) 

usesBio = Y/N(The value is "y" if at least one biometric element "Bio" (part of "Bios" element) 
used in authentication) 

usesBiollR = Y/N (The value is "y" if "HR" is part of the list, then at least one "Bio” element 
with type HR should be used) 

usesBioFMR = Y/N(The value is "y" If "FMR" is part of the list, then at least one "Bio" element 
with type FMR should be used) 

usesBioFIR = Y/N(The value is "y" If "FIR" is part of the list, then at least one "Bio" element 
with type FIR should be used) 

OtpChannel = 00/01/02(send OTP via both SMS and Email/ send OTP via SMS only/ 
send OTP via Email only) 


For more details please go through documents provided in http://www.uidai.aov.in site. 
http://uidai.aov.in/imaaes/FrontPaaeUpdates/aadhaar authentication api 1 5 revl 1.pdf 


5.4 Log4j.xml 

To set the application log file location need to set the property in log4j.xml file. 


<param name="file" value="<root path>/logs/auaserver.log"/> 
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6 EID-UID-XML-batch-process jar deployment 


Step 1: Copy the EID-UID-XML-batch-process-<version>.jar in to a folder in the server. 

Step 2: Change the below property files. 

Step 3: Create the script file (.sh or .bat) to execute and update the jar file name and location. 
Step 4: Execute the script. See the Section 5.5. 

Property Files 

1. batchProcessor.properties 

2. DatabaseResources.properties 

3. authclient.properties 

4. applicationContext_hibernate.xml 

5. log4j.xml 

To make the changes in property files open the jar with 7zip and change the values as per below 
instructions. 

6.1 BatchProcessor.properties 

This Property file is used for XML Batch processing. 


batchProcessor. maxThreadCount=5 

This property is used to set the no of thread should run while processing EID UID XML files. 

If we keep 1 thread, one EID UID XML file will be processed at a time. If we keep 5 threads, 5 EID 
UID XML files will be processed simultaneously. 

Thread count can keep 1-10. Ideal is to keep 3-5. 

Very importantly when we are running more threads, need to set more ram for the batch process 
in the shell script. 


pollerRepeatlntervallnMiliSec= 86400000 
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pollerRepeatlntervallnMiliSec property is used to schedule the batch process running intervals. 
Batch process automatically run based on given intervals. 

For the better performance schedule the batch process run at nights. 

# For 24 Flours = 86400000 Milliseconds 

# For 12 Flours = 43200000 Milliseconds 

# For 10 Flours = 36000000 Milliseconds 

# For 5 Flours = 18000000 Milliseconds 

# For 2 Flours = 7200000 Milliseconds 

# For 1 Flours = 3600000 Milliseconds 


batchProcessor.stateEnableFlag=bi 

batchProcessor.stateEnableFlag is used to instruct the batch process to upload only state 
resident data or non-state resident data. 

If you keep the batchProcessor.stateEnableFlag=Y, then batch process will upload only 
respective state resident data. 

If you keep the batchProcessor.stateEnableFlag=N, then batch process will upload both state 
resident data and non-state resident data. 

Please do not change this value. Keep the default value to ‘N’. 

batchProcessor.stateName=<s\a\e name as mentioned in the EID UID XML FILES> 

this property is applicable only if above property (batchProcessor.stateEnableFlag=Y) is set to 
‘Y’. 


It is mandatory to set the state name for the batchProcessor.stateName property. Then only batch 
process will upload the state resident data. 


batchProcessor.authenticationFlag=N 
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batchProcessor.authenticationFlag is used to set the unencrypted files data is required to be 
authenticated against CIDR or not. 

If flag is set to ‘Y’, then every resident data will be authenticated with CIDR. For this state has to 
be sing with CIDR as a ASA. 

If flag is set to ‘N\ then data will not be authenticated with CIDR and un-accurate data may 
uploaded to SRDH data repository. 


batch Processor, photoupda teFlag= Y 

batchProcessor.photoupdateFlag is used to set for photo need to be updated or not while any 
updating is happening on any resident data in SRDH through XML files. This flag is useful if state 
has uploaded the latest photos through SRDH application, and no need to get updated with CIDR 
photo while updating data through EID UID XML files. 

Default value is ‘Y’. 


Folder configurations: 

Make sure before deploying the jar below folder has to be created in the server and configured in 
property file. 

batchProcessor.EncryptedXMLFolder = <root path >//encrypted// 
batchProcessor.UnEncryptedXMLFolder = <root pat h>//unencrypted// 
batch Processor. ProcessedFolder=<mol path >//processed// 
batch Processor. FailedFolder=<roo\ path >//failed tt 
batchProcessor.XSDLocation=<roo\ path>//Xsd //KYR.xsd 

(Enrollment XSD files(KYR.xsd supplied with the package) need to be copy in to this folder before 
deploying the Jar) 

batch Processor. Decryption Folder=<rool pa\h>//srdhtemp// 
batch Processor. Decryption KeyFolder=<roo\ path>///reys// 

(Encryption & Decryption Keys and Certificates related files need to be copy in to this folder 
before deploying the Jar) 
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Enrollment Type Configurations: 

Please do not change these values. 

Below values comes with EID UID XML files. If any changes in EID UID XML files then need to 
change these values. Also need to do changes in code accordingly. 

enrollmentType.newEnrollment=ENROLMENT 

enrollmentType.update= UPDA TION 

enrollmentType. correction= CORRECTION 

Enrollment Status Configurations: 

Please do not change these values. 

Below values comes with EID UID XML files. If any changes in EID UID XML files then need to 
change these values. Also need to do changes in code accordingly. 

enrollmentStatus.processedSuccessfully=PROCESSED_SUCCESSFULLY 

enrollmentStatus.rejected=REJECTED 

enrollmentStatus.issued=ISSUED 

SRDH Specific Status Configurations: 

Please do not change these values. 

If any code change happens in SRDH application then accordingly same values need to configure 
in batch process property file. 

batchProcessor.user=BA TCH 
batchProcessor. residentSta tus= Active 
batchProcessor. deactivateFlag= N 
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batchProcessor.versionHistorySize property is to set the number of history records maintain for 
enrollment updates in enrollment_versions and enrollment_version_details tables. 

batchProcessor. versionHistorySize= 10 


6.1 databaseResources.properties File Configurations: 


File Name: DatabaseResources.properties 

Location: EID-UID-XML-batch-process jar 


Below data sources are created for SRDH application to give flexibility to separate the tables in to 
multiple Servers or multiple schemas to increase the performance and share the data load. 

If all the tables are created in a single server/ schema, then all data sources will contain same 
values. 

Based on the state population we need to decide sharing of data in to various schemas and 
tables. 

For example Version History tables can contain 10 version of each enrollment in enrollment table. 
So this can be shared in to multiple database instances. 

Versions history tables are maintained based on starting number of the UID (1-9). 

And can be configured from 1 to 9 schemas based on the size of data. 

Before configuring this data sources in properties file. Please run the database scripts supplied 
with this release and create schemas and tables. Ensure all the scripts are executed successfully. 
After creating schemas provide the database details in property file as described below. 

• /7/'bernafe.c//a/ecf=org.hibernate.dialect.MySQLDialect 
We need to specify the dialect for hibernate based on the database type. 

Dialects for different databases: 

MySQL Dialect: org.hibernate.dialect.MySQLDialect 
MSSQL Dialect: org.hibernate.dialect.SQLServerDialect 
ORACLE Dialect: org.hibernate.dialect.OraclelOgDialect 
DB2 Dialect: org.hibernate.dialect.DB2Dialect 


• hiberna te. show_ sql=i a I s e 
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hibernate.show_sql property is used to set the property to show hibernate generated 
SQL queries on console or not. 

True will show the SQL queries and false will not show the SQL queries on console. 
This feature is used to debug if any issues. 


Sharding Configurations: 

This property indicates the number of sharding for the Enrollment Table. This property is 
mandatory and need to set the value carefully based on the enrollment sharding schemas. 


Note: Sharding properties should be configured same as defined for SRDH Portal 
above. 


srdh.numberOfEnrollmentDataSource=< N u m be r> 

Example: srdh.numberOfEnrollmentDataSource=9 

Below 9 properties defines which UID (Starting Number of UID) has to store in which 
shared enrollment schema. 
srdh.enrollmentUid.1=<Shared Schema Number> 
srdh.enrollmentUid.2=<Shared Schema Number> 
srdh.enrollmentUid.3=<Shared Schema Number> 
srdh.enrollmentUid.4=<Shared Schema Number> 
srdh.enrollmentUid.5=<Shared Schema Number> 
srdh.enrollmentUid.6=<Shared Schema Number> 
srdh.enrollmentUid.7=<Shared Schema Number> 
srdh.enrollmentUid.8=<Shared Schema Number> 

Example for 9 Shards: (Suggested for Population between 8-20 crores) 

srdh.numberOfEnrollmentDataSource=9 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=2 

srdh.enrollmentUid.3=3 

srdh.enrollmentUid.4=4 

srdh.enrollmentUid.5=5 

srdh.enrollmentUid.6=6 

srdh.enrollmentUid.7=7 

srdh.enrollmentUid.8=8 

srdh.enrollmentUid.9=9 

Example for 4 Shards: (Suggested for Population between 4-8 crores) 

srdh.numberOfEnrollmentDataSource=4 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=1 

srdh.enrollmentUid.3=1 

srdh.enrollmentUid.4=2 

srdh.enrollmentUid.5=2 

srdh.enrollmentUid.6=3 
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srdh.enrollmentUid.7=3 

srdh.enrollmentUid.8=4 

srdh.enrollmentUid.9=4 


Example for 2 Shards: (Suggested for Population between 2-4 crores) 

srdh.numberOfEnrollmentDataSource=2 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=1 

srdh.enrollmentUid.3=1 

srdh.enrollmentl)id.4=1 

srdh.enrollmentUid.5=1 

srdh.enrollmentUid.6=2 

srdh.enrollmentUid.7=2 

srdh.enrollmentUid.8=2 

srdh.enrollmentUid.9=2 

Example for 1 Shard: (Suggested for Population between 0-2 crores) 

srdh.numberOfEnrollmentDataSource=1 

srdh.enrollmentUid.1=1 

srdh.enrollmentUid.2=1 

srdh.enrollmentUid.3=1 

srdh.enrollmentUid.4=1 

srdh.enrollmentUid.5=1 

srdh.enrollmentUid.6=1 

srdh.enrollmentUid.7=1 

srdh.enrollmentUid.8=1 

srdh.enrollmentUid.9=1 


Database Drivers: 

MySQL Driver: com.mysql.jdbc.Driver 

Oracle Driver: oracle.jdbc.driver.OracleDriver 

MS SQL Driver: com.microsoft.sqlserver.jdbc.SQLServerDriver 

DB2 Driver: com.ibm.db2.jcc.DB2Driver 

Common Data Source configurations: 

commonDataSourceDriver=<Database driver name> 
commonDataSourceUrl=<Da\a Source URL> 
commonDataSourceUsername=<Da\abase User Name> 
commonDataSourcePassword=ENC{<Ena)/p\ed Database Password>) 
commonDataSource.defaultSchema=<Commor\ Schema Name> 

Example: 
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commonDataSourceDriver=com.mysql.jdbc. Driver 

commonDataSourceUrl=jdbc:mysql://1 27.0.0.1:3306/srdhcommon?useUnicode=yes&characterEn 
coding=UTF-8 

commonDataSourceUsername=root 

commonDataSourcePassword=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.common=srdhcommon 


Note: Based on no of shards, we need to create enrollment schemas in database and configure 
the data sources below accordingly. 

Enrollment Data Source configuration for the enrollment sharding schema One: 

enrollmentDataSourceDriver1=<Da\abase driver name> 
enrollmentDataSourceUrl1=<Da\a Source URL> 
enrollmentDataSourceUsername1=<Da\abase User Name> 
enrollmentDataSourcePassword1= ENC(<Encrypted Database Password>) 
enrollmentDataSource.defaultSchema 7=<Enrollment Sharding First Schema Name> 

Example: enrollmentDataSourceDriverl =com.mysql.jdbc.Driver 

enrollmentDataSourceUrl1=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment1 ?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername1=root 

enrollmentDataSourcePassword1=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment1=srdhenrollment1 

Enrollment Data Source configuration for the enrollment sharding schema Two: 

Note: This configuration is required only if you are using two or more shardings. 

enrol I men tDa taSourceDri ver2= <Database driver name> 
enrollmentDataSourceUrl2=<Da\a Source URL> 
enrollmentDataSourceUsername2=<Da\abase User Name> 
enrollmentDataSourcePassword2= E NC (< E ncry pted Database Password>) 
enrollmentDataSource.defaultSchema2 =< Enrollment Sharding Second Schema Name > 

Example: enrollmentDataSourceDriver2=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl2=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment2?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername2=root 

enrollmentDataSourcePassword2=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

enrollmentDataSource.defaultSchema2=srdhenrollment2 
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Enrollment Data Source configuration for the enrollment sharding schema Three: 

Note: This configuration is required only if you are using three or more shardings. 

enrollmentDataSourceDriver3=<Da\abase driver name> 
enrollmentDataSourceUrl3=<Da\a Source URL> 
enrollmentDataSourceUsername3=<Da\abase User Name> 
enrollmentDataSourcePassword3= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment3=< Enrollment Sharding Third Schema Name > 

Example: enrollmentDataSourceDriver3=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl3=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment3?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername3=root 

enrollmentDataSourcePassword3=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

enrollmentDataSource.defaultSchema3=srdhenrollment3 

Enrollment Data Source configuration for the enrollment sharding schema Four: 

Note: This configuration is required only if you are using four or more shardings. 

enrol I men tDa taSourceDri ver4= <Database driver name> 
enrollmentDataSourceUrl4=<Da\a Source URL> 
enrollmentDataSourceUsername4=<Da\abase User Name> 
enrollmentDataSourcePassword4= E NC (< E ncry pted Database Password>) 
enrollmentDataSource.defaultSchema4=< Enrollment Sharding Forth Schema Name > 

Example: enrollmentDataSourceDriver4=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl4=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment4?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername4=root 

enrollmentDataSourcePassword4=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

enrollmentDataSource.defaultSchema4=srdhenrollment4 

Enrollment Data Source configuration for the enrollment sharding schema Five: 

Note: This configuration is required only if you are using five or more shardings. 

enrol I men tDa taSourceDri ver5=< Database driver name> 
enrollmentDataSourceUrl5=<Da\a Source URL> 
enrollmentDataSourceUsername5=<Da\abase User Name> 
enrollmentDataSourcePassword5= E NC (< E ncry pted Database Password>) 
enrollmentDataSource.defaultSchema5=< Enrollment Sharding Fifth Schema Name > 
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Example: enrollmentDataSourceDriver5=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl5=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment5?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername5=root 

enrollmentDataSourcePassword5=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

enrollmentDataSource.defaultSchema5=srdhenrollment5 

Enrollment Data Source configuration for the enrollment sharding schema Six: 

Note: This configuration is required only if you are using six or more shardings. 

enrollmentDataSourceDriver6=<Da\abase driver name> 
enrollmentDataSourceUrl6=<Da\a Source URL> 
enrollmentDataSourceUsername6=<Da\abase User Name> 
enrollmentDataSourcePassword6= ENC(<Encrypted Database Password>) 
enrollmentDataSource.defaultSchema6=< Enrollment Sharding Sixth Schema Name > 

Example: enrollmentDataSourceDriver6=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl6=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment6?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername6=root 

enrollmentDataSourcePassword6=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

enrollmentDataSource.defaultSchema6=srdhenrollment6 

Enrollment Data Source configuration for the enrollment sharding schema Seven: 

Note: This configuration is required only if you are using seven or more shardings. 

enrollmentDataSourceDriver7=<Da\abase driver name> 
enrollmentDataSourceUrl7=<Da\a Source URL> 
enrollmentDataSourceUsername7=<Da\abase User Name> 
enrollmentDataSourcePassword7= E NC (< E ncry pted Database Password>) 
enrollmentDataSource.defaultSchema7=< Enrollment Sharding Seventh Schema Name > 

Example: enrollmentDataSourceDriver7=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl7=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment7?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername7=root 

enrollmentDataSourcePassword7=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

enrollmentDataSource.defaultSchema7=srdhenrollment7 

Enrollment Data Source configuration for the enrollment sharding schema Eight: 

Note: This configuration is required only if you are using eight or more shardings. 
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enrollmentDataSourceDriver8=<Da\abase driver name> 
enrollmentDataSourceUrl8=<Da\a Source URL> 
enrollmentDataSourceUsemame8=<Da\abase User Name> 
enrollmentDataSourcePassword8= ENC(<Encrypted Database Password>) 
enrollmentDataSource.defaultSchema8=< Enrollment Sharding Eighth Schema Name > 

Example: enrollmentDataSourceDriver8=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl8=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment8?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername8=root 

enrollmentDataSourcePassword8=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

enrollmentDataSource.defaultSchema8=srdhenrollment8 

Enrollment Data Source configuration for the enrollment sharding schema Nine. 

Note: This configuration is required only if you are using nine shardings. 

enrol I men tDa taSourceDri ver9= <Database driver name> 
enrollmentDataSourceUrl9=<Da\a Source URL> 
enrollmentDataSourceUsername9=<Da\abase User Name> 
enrollmentDataSourcePassword9= E NC (< E ncry pted Database Password>) 
enrollmentDataSource.defaultSchema9=< Enrollment Sharding Ninth Schema Name > 

Example: enrollmentDataSourceDriver9=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl9=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment9?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername9=root 

enrollmentDataSourcePassword9=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

enrollmentDataSource.defaultSchema9=srdhenrollment9 


Version History Data Source Configurations: 

versionHistoryDataSourceDriver1=<Da\abase driver name> 
versionHistoryDataSourceUrl1==< Data Source URL> 
versionHistoryDataSourceUsername1=<Da\abase User Name> 
versionHistoryDataSourcePassword1=ENC(<Er\cryp\e6 Database Password>) 
versionHistoryDataSource.defaultSchema1=<\/ers\or\ History Schema Name> 
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Example: versionHistoryDataSourceDriverl =com.mysql.jdbc.Driver 

versionHistoryDataSourceUrl1=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh1 ?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername1=root 

versionHistoryDataSourcePassword1=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

versionHistoryDataSource.defaultSchema1=srdhenrollmentvh1 

versionHistoryDataSourceDriver2=<Da\abase driver name> 
versionHistoryDataSourceUrl2=< Data Source URL> 
versionHistoryDataSourceUsername2= <Database User Name> 
versionHistoryDataSourcePassword2=ENC(<Encryp{e6 Database Password>) 
versionHistoryDataSource.defaultSchema2=<\/ers\or\ History Schema Name> 

Example: versionHistoryDataSourceDriver2=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl2=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh2?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername2=root 

versionHistoryDataSourcePassword2=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

versionHistoryDataSource.defaultSchema2=srdhenrollmentvh2 

versionHistoryDataSourceDriver3=<Da\abase driver name> 
versionHistoryDataSourceUrl3=< Data Source URL> 
versionHistoryDa ta Source Usemame3= <Database User Name> 
versionHistoryDataSourcePassword3=ENC(<Encryp{e6 Database Password>) 
versionHistoryDataSource.defaultSchema3=<\/ers\on History Schema Name> 

Example: versionHistoryDataSourceDriver3=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl3=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh3?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername3=root 

versionHistoryDataSourcePassword3=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

versionHistoryDataSource.defaultSchema3=srdhenrollmentvh3 

versionHistoryDataSourceDriver4=<Da\abase driver name> 
versionHistoryDa ta Source Ur 14= < Data Source URL> 
versionHistoryDa ta Source Username4= < D at a base User Name> 
versionHistoryDataSourcePassword4=ENC{<Enayp\ed Database Password>) 
versionHistoryDataSource.defaultSchema4=<\/ers\on History Schema Name> 

Example: 
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versionHistoryDataSourceDriver4=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl4=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh4?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername4=root 

versionHistoryDataSourcePassword4=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

versionHistoryDataSource.defaultSchema4=srdhenrollmentvh4 


versionHistoryDataSourceDriver5=<Da\abase driver name> 
versionHistoryDataSourceUrl5=< Data Source URL> 
versionHistoryDataSourceUsername5= <Database User Name> 
versionHistoryDataSourcePassword5=ENC(<Encryp\eb Database Password>) 
versionHistoryDataSource.defaultSchema5=<\/ers\on History Schema Name> 

Example: versionHistoryDataSourceDriver5=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl5=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh5?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername5=root 

versionHistoryDataSourcePassword5=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

versionHistoryDataSource.defaultSchema5=srdhenrollmentvh5 


versionHistoryDataSourceDriver6=<Da\abase driver name> 
versionHistoryDataSourceUrl6=< Data Source URL> 
versionHistoryDa ta Source Username6= <Database User Name> 
versionHistoryDataSourcePassword6=ENC(<Encryp\edi Database Password>) 
versionHistoryDataSource.defaultSchema6=<\/ers\on History Schema Name> 

Example: versionHistoryDataSourceDriver6=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl6=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh6?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername6=root 

versionHistoryDataSourcePassword6=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

versionHistoryDataSource.defaultSchema6=srdhenrollmentvh6 


versionHistoryDataSourceDriver7=< Database driver name> 
versionHistoryDataSourceUrl7=< Data Source URL> 
versionHistoryDataSourceUsername7=<Da\abase User Name> 
versionHistoryDataSourcePassword7=ENC(<Eroryp\edi Database Password>) 
versionHistoryDataSource.defaultSchema7=<\/ers\on History Schema Name> 
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Example: versionHistoryDataSourceDriver7=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl7=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh7?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername7=root 

versionHistoryDataSourcePassword7=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

versionHistoryDataSource.defaultSchema7=srdhenrollmentvh7 


versionHistoryDataSourceDriver8=<Da\abase driver name> 
versionHistoryDataSourceUrl8==< Data Source URL> 
versionHistoryDataSourceUsername8= <Database User Name> 
versionHistoryDataSourcePassword8=ENC(<Encryp{e6 Database Password>) 
versionHistoryDataSource.defaultSchema8=<\/ers\on History Schema Name> 

Example: versionHistoryDataSourceDriver8=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl8=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh8?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername8=root 

versionHistoryDataSourcePassword8=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

versionHistoryDataSource.defaultSchema8=srdhenrollmentvh8 


versionHistoryDataSourceDriver9=<Da\abase driver name> 
versionHistoryDataSourceUrl9=< Data Source URL> 
versionHistoryDataSourceUsemame9=<Da\abase User Name> 
versionHistoryDataSourcePassword9= ENC(<Encrypted Database Password>) 
versionHistoryDataSource.defaultSchema9=<\/ers\on History Schema Name> 

Example: versionHistoryDataSourceDriver9=com.mysql.jdbc. Driver 

versionHistoryDataSourceUrl9=jdbc:mysql://172.19.73.62:3306/srdhenrollmentvh9?useUnicode=y 

es&characterEncoding=UTF-8 

versionHistoryDataSourceUsername9=root 

versionHistoryDataSourcePassword9=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

versionHistoryDataSource.defaultSchema9=srdhenrollmentvh9 


6.2 authclient.properties Property File Configurations: 


SRDH AUA Client Configurations: 
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To get details of below parameters please go through Authentication API 1.6 documentation from 
UIDAI Portal. Below are the configurations of UIDAI test environment. 

usesBio= N 
useSSK= Y 
usesPfa=N 
usesPi= N 
usesOtp= N 
usesP/n=N 
usesPa =N 
usesBiollR= N 
usesBioFMR= N 
usesB/oF//?=N 
useSyncKey = YES 
tokentype=00'\ 
tokennumber= 
version =1.6 
/ov=560103 
/cfc=NA fcfc=NC 
lattitude= 
longitude= 
pincode= 560103 
lot= P 

pidType= BOTH 

publiclP^ 27.0.0.1 

fe/777/'/7a//c/=public 

sa=public 

auaCoc/e=public 

signa turePassword= public 

signa tureAlias= public 

uc/c=UIDAI\:SampleClient 

nameMatchingStrategy=<E/P> (E-Exact Match P- Partial Match) 

nameExactMatchValue=^00 (Value in Percentage) 

namePartialMatchValue=60 (Value in Percentage) 

addressMatchingStrategy=<E/P> (E-Exact Match P- Partial Match) 
addressExactMatchValue^OO (Value in Percentage) 

addressPartialMatchValue=60 (Value in Percentage) 

dobType=<M 7A/D> (V-Verified, A-Approximate, D-Declared) 

//cense/Cey=MC3GC07a7TT0meGKwxl2tVf7NVLMY+AQ2WhCbDgW4qYip0wVXdrXclg\= 
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otpServerUrl=< OTP server URL> (Example : http\://auth.uidai.gov.in/otp/1.5) 
bfdServerilrl=< BFD server URL> (Example : http\://auth.uidai.gov.in/bfd/1.6) 
authServerUrl=</\D/\ server URL> (Example : http\://localhost:8080/aua/auaservice/) 

publicKeyFile=<Key Location Path> (Example: //home//srdh//keys//uidai_auth_stage.cer) 
signKeyStore=< signKeyStore Location Path> (Example: //home//srdh//keys//public- 
may2012.p12) 

In above configuration parameters we need to change only Key file Location and Auth Server 
Location. 

6.3 applicationContext.xml Changes: 


In applicationContext.xml file we need to enable properties for all the session factories based on 
the no of shardings. 

Based on no.of shardings need to un-comment the enrollmentDataSources and 
enrollmentSessionFactories. Given instructions in applicationContext.xml file. 

In below bean tag you need to un-comment (Yellow Marked) enrollmentSessionFactories based 
on no.of. shardings. 

<bean id="dbController" class="in.gov.uidai.srdh.batch.xmlprocessor.util.DbControllerUtil"> 
<property name="commonSessionFactory" ref="commonSessionFactory" /> 

<property name="enrollmentSessionFactory1" ref="enrollmentSessionFactory1" /> 
<property name="enrollmentSessionFactory2" ref="enrollmentSessionFactory2" /> 
<property name="enrollmentSessionFactory3" ref="enrollmentSessionFactory3" /> 
<property name="enrollmentSessionFactory4" ref="enrollmentSessionFactory4" /> 

<property name="enrollmentSessionFactory5" ref="enrollmentSessionFactory5" /> 
<property name="enrollmentSessionFactory6" ref="enrollmentSessionFactory6" /> 
<property name="enrollmentSessionFactory7" ref="enrollmentSessionFactory7" /> 
<property name="enrollmentSessionFactory8" ref="enrollmentSessionFactory8" /> 

<property name="enrollmentSessionFactory9" ref="enrollmentSessionFactory9" /> 


<property name="versionFlistorySessionFactory1" ref="versionFlistorySessionFactory1" /> 
<property name="versionFlistorySessionFactory2" ref="versionFlistorySessionFactory2" /> 
<property name="versionFlistorySessionFactory3" ref="versionFlistorySessionFactory3" /> 
<property name="versionHistorySessionFactory4" ref="versionFlistorySessionFactory4" /> 
<property name="versionHistorySessionFactory5'' ref="versionHistorySessionFactory5" /> 
<property name="versionFlistorySessionFactory6" ref="versionHistorySessionFactory6" /> 
<property name="versionFlistorySessionFactory7" ref="versionFlistorySessionFactory7" /> 
<property name="versionFlistorySessionFactory8" ref="versionFlistorySessionFactory8" /> 
<property name="versionFlistorySessionFactory9" ref="versionFlistorySessionFactory9" /> 
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</bean> 

6.4 Log4j.xml 

To set the application log file location need to set the property in log4j.xml file. 


<param name="file" value="<root path>/logs/batchProcess.log7> 


6.5 Executing EID-UID-XML-batch-process jar 


Note: First need to copy the hibernate-configuration-3.0.dtd and hibernate-mapping-3.0.dtd files 
into folder where you placed the jar file. 


java -Xmx<ram size>g -jar <jar file path>/EID-UID-XML-batch-process-<version no>.jar 


(Example: java -XmxIOg -jar/home/uidai-srdh/batchprocess/EID-UID-XML-batch-process- 
2.7.1.1.jar) 

Run the above command directly in $ prompt /dos prompt or keep the above statement in .sh (for 
unix) or ,bat(for windows) and run the file. 


Check the log open the file in above configured location for any errors. 
To stop process, in the running widow press Ctrl + C. 


7 BatchSeedingCsv jar deployment 


Step 1: Copy the BatchSeedingCsv-<version>.jar in to a folder in the server. 

Step 2: copy hibernate-configuration-3.0.dtd and hibernate-mapping-3.0.dtd files into folder where 
you copied jar file. 

Step 3: Change the below property files. 

Step 4: Create the script file (.sh or .bat) to execute and update the jar file name and location. 
Step 5: Execute the script. See the Section 5.5. 


Property Files 

1. batchSeeding.properties 

2. DatabaseResources.properties 

3. applicationContext.xml 

4. log4j.xml 
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7.1 batchSeeding.properties 

CSV File Location Path 

Please create below folders in server before deploying this jar and then update the values in 
properties file. 

batchseeding.inputCsvFilePath = <root path >//csv//input// 
batchseeding.processedPath = <root path >//csv//processed// 
batchseeding.rejectedpath = <root path >//csv//failed// 

Time interval for the batch seeding polar. 

batchseeding.pollerRepeatlntervallnMiliSec= 86400000 (24hrs) 

Phonetic Search results name matching percentage. Usually no need to changes this option. 

batchSeeding. phonaticNameMatching=70 

Search Threshold Percentage. (If matching percentage is more than Threshold value then only 
the record will shown in the application) 

batchseeding. partialMatchThreshold=60 

Exact Address Match Percentage 

batchseeding.exactAddressMatch=100 

No. of search results shown in the display (JSP). 

batchseeding.searchResultsRequired=10 

batchseeding.weightageThreshold = 40 

This value is used to add a column in where clause in the query while performing partial search. 
Default value for this column is 40. 
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Default Weightages for the CSV field values. If user won’t provide weightages in CSV file, system 
automatically pick the default waitages from the property file. Based on below configurations. 

batchseeding.defaultWeightageForName=70 

batchseeding.defaultWeightageForGender=5 

batchseeding.defaultWeightageForAddress=5 

batchseeding.defaultWeightageForDob=5 

batchseeding.defaultWeightageForDistrict=5 

batchseeding.defaultWeightageForState=5 

batchseeding.defaultWeightageForpPincode=5 


7.2 DatabaseResources.properties 

Database Drivers: 

MySQL Driver: com.mysql.jdbc.Driver 

Oracle Driver: oracle.jdbc.driver.OracleDriver 

MS SQL Driver: com.microsoft.sqlserver.jdbc.SQLServerDriver 

DB2 Driver: com.ibm.db2.jcc.DB2Driver 

Common Data Source configurations for the common tables: 

Common Tables: 

(audit_advanced_search, audit_search, audit_webservice_aua, audit_webservice_search, 
batch_enrollment, deactivate_reason, enrollment_rejection, ext_db_types, external_db, 
failure_reason, failure_reason_aua, language, permissions, process_status, rejection_reason, 
role, role_permission, self_service, srdhuser, state, system_parameters, user_query, 
vault_download, vault_upload) 

commonDataSourceDriver=<Da\abase driver name> 
commonDataSourceUrl=<Da\a Source URL> 
commonDataSourceUsername=<Da\abase User Name> 
commonDataSourcePassword=ENC{<Enoryp\edi Database Password>) 
hibernate.defaultSchema.common=<Comrr\on Schema Name> 

Example: commonDataSourceDriver=com.mysql.jdbc. Driver 

commonDataSourceUrl=jdbc:mysql://1 27.0.0.1:3306/srdhcommon?useUnicode=yes&characterEn 
coding=UTF-8 

commonDataSourceUsername=root 

commonDataSourcePassword=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.common=srdhcommon 

Seeding Data Source configurations for the seeding tables: 

Seeding Tables: 
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(seeding, seeding_batch, seeding_batch_input, seeding_batch_output, seeding_batch_temp, 
seeding_batch_weightage, seeding_department, seeding_dictionary) 

seedingDataSourceDriver=< Database driver name> 
seedingDataSourceUrl=< Data Source URL> 
seedingDataSourceUsername=<Da\abase User Name> 
seedingDataSourcePassword=ENC(<E.r\cryp\e6 Database Password>) 
hibernate.defaultSchema.seeding=<See6\r\g Schema Name> 

Example: seedingDataSourceDriver=com.mysql.jdbc. Driver 

seeding DataSourceUrl=jdbc:mysql://1 27.0.0.1:3306/srdhseeding?useUnicode=yes&characterEnc 
oding=UTF-8 

seeding DataSourceUsername=root 

seeding DataSourcePassword=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate.defaultSchema.seeding=srdhseeding 

QueryBuilder Data Source can be configured to Schema where the Temporary tables are 
created by the system. 

queryBuilderDataSourceDriver=<Da\abase driver name> 
queryBuilderDataSourceUrl==<Da\a Source URL> 
queryBuilderDataSourceUsemame=<Da\abase User Name> 
queryBuilderDataSourcePassword= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.querybuilder=<Query Builder Schema Name> 

Example: queryBuilderDataSourceDriver=com.mysql.jdbc. Driver 

queryBuilderDataSourceUrl=jdbc:mysql://1 27.0.0.1:3306/srdhquerybuilder?useUnicode=yes&char 

acterEncoding=UTF-8 

queryBuilderDataSourceUsername=root 

queryBuilderDataSourcePassword=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 

hibernate.defaultSchema.querybuilder=srdhquerybuilder 

Note: Based on no of shards, we need to create enrollment schemas in database and configure 
the data sources below accordingly. 

Sharding properties should be configured same as defined for SRDH Portal above. 


Enrollment Data Source configuration for the enrollment sharding schema One: 

enrollmentDataSourceDriver1=<Da\abase driver name> 
enrollmentDataSourceUrl1=<Da\a Source URL> 
enrollmentDataSourceUsername1=<Da\abase User Name> 
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enrollmentDataSourcePassword1= ENC(<Encrypted Database Password>) 
hiberna te. defaultSchema. enrollment1=< E n ro 11 m e n t Sharding First Schema Name> 

Example: enrollmentDataSourceDriverl =com.mysql.jdbc.Driver 

enrollmentDataSourceUrl1=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment1 ?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername1=root 

enrollmentDataSourcePassword1=ENC(8gn+TzYX10XmoYFIZ9hjX7A==) 
hibernate.defaultSchema. enrollment1=srdhenrollment1 

Enrollment Data Source configuration for the enrollment sharding schema Two: 

Note: This configuration is required only if you are using two or more shardings. 
enrol I men tDa taSourceDri ver2= <Database driver name> 
enrollmentDataSourceUrl2=<Da\a Source URL> 
enrollmentDataSourceUsername2=<Da\abase User Name> 
enrollmentDataSourcePassword2= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment2=< Enrollment Sharding Second Schema Name > 

Example: enrollmentDataSourceDriver2=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl2=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment2?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername2=root 

enrollmentDataSourcePassword2=ENC(8gn+TzYX10XmoYPIZ9hjX7A==) 
hibernate.defaultSchema. enrollment2=srdhenrollment2 


Enrollment Data Source configuration for the enrollment sharding schema Three: 

Note: This configuration is required only if you are using three or more shardings. 

enrol I men tDa taSourceDri ver3= <Database driver name> 
enrollmentDataSourceUrl3=<Da\a Source URL> 
enrollmentDataSourceUsername3=<Da\abase User Name> 
enrollmentDataSourcePassword3= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment3=< Enrollment Sharding Third Schema Name > 

Example: enrollmentDataSourceDriver3=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl3=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment3?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername3=root 

enrollmentDataSourcePassword3=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate.defaultSchema. enrollment3=srdhenrollment3 
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Enrollment Data Source configuration for the enrollment sharding schema Four: 

Note: This configuration is required only if you are using four or more shardings. 

enrol I men tDa taSourceDri ver4= <Database driver name> 
enrollmentDataSourceUrl4=<Da\a Source URL> 
enrollmentDataSourceUsername4=<Da\abase User Name> 
enrollmentDataSourcePassword4= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment4=< Enrollment Sharding Forth Schema Name > 

Example: enrollmentDataSourceDriver4=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl4=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment4?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername4=root 

enrollmentDataSourcePassword4=ENC(8gn+TzYX10XmoYFIZ9hjX7A==) 
hibernate. defaultSchema.enrollment4=srdhenrollment4 

Enrollment Data Source configuration for the enrollment sharding schema Five: 

Note: This configuration is required only if you are using five or more shardings. 

enrollmentDataSourceDriver5=<Da\abase driver name> 
enrollmentDataSourceUrl5=<Da\a Source URL> 
enrollmentDataSourceUsername5=<Da\abase User Name> 
enrollmentDataSourcePassword5= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment5=< Enrollment Sharding Fifth Schema Name > 

Example: enrollmentDataSourceDriver5=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl5=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment5?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername5=root 

enrollmentDataSourcePassword5=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment5=srdhenrollment5 

Enrollment Data Source configuration for the enrollment sharding schema Six: 

Note: This configuration is required only if you are using six or more shardings. 

enrollmentDataSourceDriver6=<Da\abase driver name> 
enrollmentDataSourceUrl6=<Da\a Source URL> 
enrollmentDataSourceUsername6=<Da\abase User Name> 
enrollmentDataSourcePassword6= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment6=< Enrollment Sharding Sixth Schema Name > 
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Example: enrollmentDataSourceDriver6=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl6=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment6?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername6=root 

enrollmentDataSourcePassword6=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment6=srdhenrollment6 

Enrollment Data Source configuration for the enrollment sharding schema Seven: 

Note: This configuration is required only if you are using seven or more shardings. 

enrollmentDataSourceDriver7=<Daiabase driver name> 
enrollmentDataSourceUrl7=<Da\a Source URL> 
enrollmentDataSourceUsername7=<Da\abase User Name> 
enrollmentDataSourcePassword7= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment7=< Enrollment Sharding Seventh Schema Name > 

Example: enrollmentDataSourceDriver7=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl7=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment7?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername7=root 

enrollmentDataSourcePassword7=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment7=srdhenrollment7 

Enrollment Data Source configuration for the enrollment sharding schema Eight: 

Note: This configuration is required only if you are using eight or more shardings. 

enrollmentDataSourceDriver8=<Da\abase driver name> 
enrollmentDataSourceUrl8=<Da\a Source URL> 
enrollmentDataSourceUsername8=<Da\abase User Name> 
enrollmentDataSourcePassword8= E NC (< E ncry pted Database Password>) 
hibernate.defaultSchema.enrollment8=< Enrollment Sharding Eighth Schema Name > 

Example: enrollmentDataSourceDriver8=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl8=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment8?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername8=root 

enrollmentDataSourcePassword8=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate. defaultSchema.enrollment8=srdhenrollment8 

Enrollment Data Source configuration for the enrollment sharding schema Nine. 

Note: This configuration is required only if you are using nine shardings. 
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enrol I men tDa taSourceDri ver9= <Database driver name> 
enrollmentDataSourceUrl9=<Da\a Source URL> 
enrollmentDataSourceUsername9=<Da\abase User Name> 
enrollmentDataSourcePassword9= ENC(<Encrypted Database Password>) 
hibernate.defaultSchema.enrollment9=< Enrollment Sharding Ninth Schema Name > 

Example: enrollmentDataSourceDriver9=com.mysql.jdbc. Driver 

enrollmentDataSourceUrl9=jdbc:mysql://1 27.0.0.1:3306/srdhenrollment9?useUnicode=yes&chara 

cterEncoding=UTF-8 

enrollmentDataSourceUsername9=root 

enrollmentDataSourcePassword9=ENC(8gn+TzYX10XmoYHZ9hjX7A==) 
hibernate.defaultSchema.enrollment9=srdhenrollment9Table Updates: 

In process_status table process_name column value should be "CSVBATCHSEEDING” and 
process_status value should be ‘N’. 

If it is not set to N then set to ‘N’ 

INSERT INTO process_status (processjd, process_name, process_status) VALUES (2, 
'CSVBATCHSEEDING'/N'); 

OR 

UPDATE process_status SET process_status = 'N' WHERE process_name = 
'CSVBATCHSEEDING'; 


7.1 applicationContext.xml Changes: 


In applicationContext.xml file we need to enable properties for all the session factories based on 
the no of shardings. 

Based on no.of shardings need to un-comment the enrollmentDataSources and 
enrollmentSessionFactories. Given instructions in applicationContext.xml file. 

In below bean tag you need to un-comment (Yellow Marked) enrollmentSessionFactories based 
on no.of. shardings. 

As Discussed with Mahindra Satyam team we do not require the dbController bean in 
batchSeeding jar 

<bean id="dbController" class="in.gov.uidai.srdh.batch.xmlprocessor.util.DbControllerUtil"> 
<property name="commonSessionFactory" ref="commonSessionFactory" /> 

<property name="enrollmentSessionFactory1" ref="enrollmentSessionFactory1" /> 
<property name="enrollmentSessionFactory2" ref="enrollmentSessionFactory2" /> 
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<property name="enrollmentSessionFactory3" ref="enrollmentSessionFactory3" /> 
<property name="enrollmentSessionFactory4" ref="enrollmentSessionFactory4" /> 

<property name="enrollmentSessionFactory5" ref="enrollmentSessionFactory5" /> 
<property name="enrollmentSessionFactory6" ref="enrollmentSessionFactory6" /> 
<property name="enrollmentSessionFactory7" ref="enrollmentSessionFactory7" /> 
<property name="enrollmentSessionFactory8" ref="enrollmentSessionFactory8" /> 

<property name="enrollmentSessionFactory9" ref="enrollmentSessionFactory9" /> 

<property name="versionFlistorySessionFactoryr ref="versionFlistorySessionFactory1" /> 
<property name="versionFlistorySessionFactory2" ref="versionFlistorySessionFactory2" /> 
<property name="versionFlistorySessionFactory3" ref="versionFlistorySessionFactory3" /> 
<property name="versionFlistorySessionFactory4" ref="versionFlistorySessionFactory4" /> 
<property name="versionFlistorySessionFactory5" ref="versionFlistorySessionFactory5" /> 
<property name="versionFlistorySessionFactory6" ref="versionFlistorySessionFactory6" /> 
<property name="versionFlistorySessionFactory7" ref="versionFlistorySessionFactory7" /> 
<property name="versionFlistorySessionFactory8" ref="versionFlistorySessionFactory8" /> 
<property name="versionFiistorySessionFactory9" ref="versionFlistorySessionFactory9" /> 
</bean> 


7.2 Log4j.xml 

To set the application log file location need to set the property in log4j.xml file. 


<param name="file" value="<root path>/logs/batchSeeding.log"/> 


7.1 Executing BatchSeedingCsv jar 


Note: First need to copy the hibernate-configuration-3.0.dtd and hibernate-mapping-3.0.dtd files 
into folder where you placed the jar file. 


java -Xmx<ram size>g -jar <jar file path>/BatchSeedingCsv-<version no>.jar 

(Example: java -XmxIOg -jar/home/uidai-srdh/batchprocess/BatchSeedingCsv-2.7.jar) 

Run the above command directly in $ prompt (for linux), dos prompt (for windows) or keep the 
above statement in .sh (for unix) or ,bat(for windows) and run the file. 

Check the log open the file in above configured location for any errors. 
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To stop process, in the running widow press Ctrl + C. 


8 Procedure to Deploy WAR file in JBoss-as-web-7.0.2 

Update supplied wars(SRDH Portal war, Search Service war) with above configured property 
files and then start deploying the war files in application server. 

Create a WAR file and follow the following procedure to deploy on JBoss Server 

1. To start JBoss as, go to the directory of jbossHome (where jboss is installed) and execute the run 
script located in jbossHome of bin directory. For windows, domain.bat and domian.sh if for UNIX 
based systems. 

2. Once the JBoss server is running, log into the JBoss Server with following url: 
http://ipaddress:8080. The welcome screen will be displayed. Click on Administration Console to 
access server status and to perform further configurations required. 


O Welcome to JBoss Application Server 7 - Windows Internet Explorer 


^ E/l http://172.19.73.62:8080/ v X \Sg Live Search 

103 

File Edit View Favorites Tools Help 

Favorites ^ > jqgestei: - Web : 


Welcome to JBoss Application Server 7 fyfr w ; 3 fSS 

- Page ■» Safety ▼ Tools » • 





Welcome to AS 7 

Your JBoss Application Server 7 is running. 

Documentation I Quickstarts I Administration Console 
JBoss AS Project I User Forum | Report an issue 

s'ioss | JBcss Community 


Local intranet 


O Welcome to JBoss Ap... Ql Production_deployme... ^ installation guide - Mi... Q screenshot - Microsoft. 
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3. Select the server in which need to deploy 
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4. Then click on Deployments tab. This will display a tabsheet with Manage Deployments. 
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5. Then click on Add contents tab, the pop-up window will be displayed to choose the file. Upload the 
srdhportal.war file and click on Next button and then save it. 



SRDH Application Deployment Guide V.1.5 


Page 75 of 80 




























ITIahincIra Satyam 


Finally after the Deployment of required .war file pertaining to the project, the application is run on the 
system. To invoke the application, provide following URL on browser: http://<IP Address>:8080/srdhportal 
and then the login page is displayed. 
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9 SRDH Migration from Version 1.4x to 1.5. 

(This section is applicable only those who are migrating from version 1.4x to 1.5) 

Note: Before migrating into production environment, first migrate into staging environment and 
make sure all the functionalities are working fine. 

9.1 Taking back up of Existing Database 

Taking Backup only Enrollment and EnrollmentDetails tables: 

$ mysqldump -u root -ppassword srdh enrollment enrollmentdetails > srdhenrollmentdump.sql 

Taking Full Database Backup: 

$ mysqldump -u root -ppassword srdh > srdhdump.sql 

9.2 Creating Enrollment Schemas for Sharding 

8 Shards suggested for Population between 8-20 crores. 

4 Shards suggested for Population between 4-8 crores. 

2 Shards suggested for Population between 2-4 crores. 

1 Shard suggested for Population between 0-2 crores. 

Example given for 2 Shardings: 
mysql> create database srdhenrollmentl; 
mysql> create database srdhenrollment2; 

9.3 Importing data into Shared Schemas 

$ mysql -u root -ppassword srdhenrollmentl < srdhenrollmentdump.sql; 

$ mysql -u root -ppassword srdhenrollment2 < srdhenrollmentdump.sql; 
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9.4 Removing Data from Tables 

Below scripts will keep data uid starting from 2-5 in one sharding and uid starting from 6-9 in 
second sharding. 

Removing data from sharding one: 

use srdhenrollmentl; 

DLETE FROM srdhenrollmentl.enrollment where uniqueid >599999999999; 

DLETE FROM srdhenrollmentl.enrollmentdetails where uniqueid > 599999999999; 

Removing data from sharding two: 

use srdhenrollment2; 

DLETE FROM srdhenrollment2.enrollment where uniqueid < 600000000000; 

DLETE FROM srdhenrollment2.enrollmentdetails where uniqueid < 600000000000; 


9.5 Database Scripts for Version 1.5 


Note: Running below create and alter database scripts is mandatory for version 1.5. 

use srdhcommon; 

ALTER TABLE 'audit_webservice_aua' ADD COLUMN 'auditjd' BIGINT NOT NULL 
AUTOJNCREMENT FIRST, CHANGE COLUMN 

'transactionjd' 'transactionjd' VARCHAR(IOO) NULL , DROP PRIMARY KEY , ADD PRIMARY KEY 
('auditjd'); 


ALTER TABLE 'rejection_reason' CHANGE COLUMN 'rejection_desc' 'rejection_desc' 
VARCHAR(300) NOT NULL; 


ALTER TABLE 'seeding_batch' ADD COLUMN 'seeding_page' INT NULL AFTER 'updated_date'; 


ALTER TABLE 'srdh'.'srdhuser' CHANGE COLUMN 'password' 'password' VARCHAR(64) NOT NULL 
, CHANGE COLUMN 'lastpwdl' 

'lastpwdl' VARCHAR(64) NULL , CHANGE COLUMN 'Iastpwd2' 'Iastpwd2' VARCHAR(64) NULL 
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DEFAULT NULL , CHANGE COLUMN 

'Iastpwd3' 'Iastpwd3' VARCHAR(64) NULL DEFAULT NULL ; 

ALTER TABLE 'audit_webservice_aua' CHANGE COLUMN 'request_xml' 'request_xml' 

VARCHAR(7000) NULL DEFAULT NULL ; 

CREATE TABLE 'reports' ( 

'reportjd' int(ll) NOT NULL, 

'totrecwitheid' int(ll) DEFAULT NULL, 

'totrecwithuid' int(ll) DEFAULT NULL, 

'totrecinsertedingiventime' int(ll) DEFAULT NULL, 

'totrecwithimage' int(ll) DEFAULT NULL, 

'totrecwrittenintosrdh' int(ll) DEFAULT NULL, 

'totrecreadfromeiduidfiles' int(ll) DEFAULT NULL, 

'totprocessedxmlfiles' int(ll) DEFAULT NULL, 

'totfailedxmlfiles' int(ll) DEFAULT NULL, 

'totfilesininputfolder' int(ll) DEFAULT NULL, 

'totregistrarpacketsuploaded' int(ll) DEFAULT NULL, 

'totkyrpacketsuploaded' int(ll) DEFAULT NULL, 

'toteiduidfilesuploaded' int(ll) DEFAULT NULL, 

'totregistrarpacketsdownloaded' int(ll) DEFAULT NULL, 

'totkyrpacketsdownloaded' int(ll) DEFAULT NULL, 

'toteiduidfilesdownloaded' int(ll) DEFAULT NULL, 

'totuploadedxmlfileswithphoto' int(ll) DEFAULT NULL, 
'totuploadedxmlfileswithoutphoto' int(ll) DEFAULT NULL, 
'totuploadedxmlfileswithkyreiduid' int(ll) DEFAULT NULL, 
'totuploadedxmlfilesingiventime' int(ll) DEFAULT NULL, 

'totdeactivatedrec' int(ll) DEFAULT NULL, 

'totrejectedrec' int(ll) DEFAULT NULL, 

'totrecseededmanually' int(ll) DEFAULT NULL, 

'totrecseededbybatch' int(ll) DEFAULT NULL, 

'totseedingfileswaitingforprocess' int(ll) DEFAULT NULL, 

'totseedingfilesinprogress' int(ll) DEFAULT NULL, 

'totseedingfilescompleted' int(ll) DEFAULT NULL, 

'avgrecfoundforeachinputrecord' int(ll) DEFAULT NULL, 
'avgrecfoundforexactmatch' int(ll) DEFAULT NULL, 

'avgrecuserseeded' int(ll) DEFAULT NULL, 

'totrecsuccessful' int(ll) DEFAULT NULL, 

'totrecrejected' int(ll) DEFAULT NULL, 

'totactivaterec' int(ll) DEFAULT NULL, 

'totrejectedrecbyreason' int(ll) DEFAULT NULL, 

'totdeactivatedrecbydeath' int(ll) DEFAULT NULL, 
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'totdeactivatedrecbydatamismatch' int(ll) DEFAULT NULL, 
'totdeactivatedrecbytransfer' int(ll) DEFAULT NULL, 
'pcttotdeactivatedrec' int(ll) DEFAULT NULL, 
'pcttotdeactivatedrecbydeath' int(ll) DEFAULT NULL, 
'pcttotdeactivatedrecbydatamismatch' int(ll) DEFAULT NULL, 
'pcttotdeactivatedrecbytransfer' int(ll) DEFAULT NULL, 
'totonlyeiduidfiles' int(ll) DEFAULT NULL, 
'totonlyeiduidkyrfiles' int(ll) DEFAULT NULL, 
'totcidrsuccessfultransactions' int(ll) DEFAULT NULL, 
'totcidrfailedtransactions' int(ll) DEFAULT NULL, 
'totunsuccessfultransactions' int(ll) DEFAULT NULL, 
'avgeiduidfilesize' int(ll) DEFAULT NULL, 

'avgseedingfilesize' int(ll) DEFAULT NULL, 
'avgeiduidfiletimeininputfolder' varchar(lO) DEFAULT NULL, 
'avgseedingfiletimeininputfolder' varchar(lO) DEFAULT NULL, 
'pctoccupiedxmlinputfolder' int(ll) DEFAULT NULL, 
'pctoccupiedxmlerrorfolder' int(ll) DEFAULT NULL, 
'pctoccupiedseedinginputfolder' int(ll) DEFAULT NULL, 
'pctoccupiedseedingerrorfolder' int(ll) DEFAULT NULL, 
'updated_date' datetime DEFAULT NULL, 

PRIMARY KEY ('reportjd') 

) ENGINE=lnnoDB DEFAULT CHARSET=utf8; 
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10 SRDH Migration from Version 1.4x to 1.5. 

(Maharashtra Team) 

(This section is applicable only those who are migrating from version 1.4x to 1.5) 

Note: Before migrating into production environment, first migrate into staging environment 
and make sure all the functionalities are working fine. 

The reason we opted for this method were as below: 

1. Avoiding the risk of deleting the records from the tables. (Usage of DELETE statement) 

2. Exporting the entire table and importing it 9 times and then deleting the unwanted 
records from the shards would consume more time and storage. 

10.1 Exporting the enrollment and enrollment details data for shards. 

The enrolment data is imported to 9 shards using the steps below 
For shard 1 

This will export all the data of uniqueid's starting from 1 into srdh_enrollment_l.sql file 

$ mysqldump -opt -u root -p ~default-character-set=utf8 srdh -where="uniqueid > 99999999999 
and uniqueid < 200000000000 and uniqueid like '1%'" enrollment enrollment_details > 
/mysql/dump/srdh_enrollment_l.sql 

For shard 2 

$ mysqldump -opt -u root -p ~default-character-set=utf8 srdh -where="uniqueid > 199999999999 
and uniqueid < 300000000000 and uniqueid like '2%'" enrollment enrollment_details > 
/mysql/dump/srdh_enrollment_2.sql 

Similarly we have to do it for all the shards 
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10.2 Creating Enrollment Schemas for Sharding 

8 Shards suggested for Population between 8-20 crores. 

4 Shards suggested for Population between 4-8 crores. 

2 Shards suggested for Population between 2-4 crores. 

1 Shard suggested for Population between 0-2 
crores. Example given for 2 Shardings: 
mysql> create database srdhenrollmentl; 
mysql> create database srdhenrollment2; 

10.3 Importing the enrollment and enrollment details data into shards. 

Import the exported data for shard 1 into the srdhenrollmentl schema from the file. 

$ mysql -u root -p -default-character-set=utf8 srdhenrollmentl < srdh_enrollment_l.sql 

Import the exported data for shard 2 into the srdhenrollment2 schema 
$ mysql -u root -p -default-character-set=utf8 srdhenrollment2 < srdh_enrollment_2.sql 


Similarly we have to do it for all the shards 
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